feat(arcrun): mira wiki page with tag filter + accumulated WIP
- landing/app/mira/wiki: tag=mira-wiki list now shows all wiki paragraphs (depends on KBDB tag filter exposed in matrix/kbdb commit, separate repo) - landing: app/mira hub + feed split + various WIP from prior sessions - registry/components: claude_api / kbdb_create_block / kbdb_get / km_writer / platform_crypto / auth_oauth2 contracts + main.go (accumulated) - .component-builds: pkg-lock updates + index.ts adjustments (WIP) - .agents/specs/arcrun/frontend-redesign: design notes - docs/test_credentials, docs/user_requirements/arcrun-landing-page: WIP docs - cypher-executor: auth-dispatcher / wasi-shim adjustments (WIP) Includes accumulated work from prior sessions plus the wiki UI tag-filter update that surfaces the AI-generated wiki paragraphs at /mira/wiki. 🤖 Generated with [Claude Code](https://claude.com/claude-code) Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>
This commit is contained in:
@@ -0,0 +1,68 @@
|
||||
canonical_id: "kbdb_ingest"
|
||||
display_name: "KBDB 寫入"
|
||||
category: "data"
|
||||
version: "v1"
|
||||
wasi_target: "preview1"
|
||||
stability: "floating"
|
||||
runtime_compat:
|
||||
- "cf-workers"
|
||||
- "workerd"
|
||||
- "wazero"
|
||||
constraints:
|
||||
max_size_kb: 2048
|
||||
max_cold_start_ms: 50
|
||||
no_network_syscall: false
|
||||
no_filesystem_syscall: true
|
||||
io_model: "stdin_stdout_json"
|
||||
input_schema:
|
||||
type: object
|
||||
required: [api_key, text, user_id]
|
||||
properties:
|
||||
api_key:
|
||||
type: string
|
||||
description: KBDB partner key（pk_live_xxx 或 ak_xxx，後者為 arcrun OAuth 取得）
|
||||
text:
|
||||
type: string
|
||||
description: 要寫入的 block 內容
|
||||
user_id:
|
||||
type: string
|
||||
description: namespace prefix（partner key 必須對應同一 namespace）
|
||||
source:
|
||||
type: string
|
||||
description: 來源標記（例如 km-writer / rss-tech-news / telegram）
|
||||
page_name:
|
||||
type: string
|
||||
description: 頁面名稱（選填）
|
||||
kbdb_url:
|
||||
type: string
|
||||
description: KBDB API base（選填，預設 https://kbdb.finally.click）
|
||||
default: "https://kbdb.finally.click"
|
||||
output_schema:
|
||||
type: object
|
||||
properties:
|
||||
success:
|
||||
type: boolean
|
||||
data:
|
||||
type: object
|
||||
description: KBDB 回傳原始物件（含 blocks_injected 等）
|
||||
error:
|
||||
type: string
|
||||
description: 錯誤訊息（success=false 時）
|
||||
gherkin_tests:
|
||||
- scenario: "缺少 text"
|
||||
given: '{"api_key":"pk_live_x","user_id":"ns_x"}'
|
||||
then_contains: '{"success":false'
|
||||
- scenario: "缺少 api_key"
|
||||
given: '{"text":"x","user_id":"ns_x"}'
|
||||
then_contains: '{"success":false'
|
||||
- scenario: "正確寫入"
|
||||
given: '{"api_key":"pk_live_xxx","text":"hello","user_id":"inkstone_test","source":"smoke"}'
|
||||
then_contains: '{"success":true'
|
||||
tags: [data, storage, kbdb, ingest, primitive]
|
||||
description: "把單一 block 寫入 KBDB（POST /blocks/ingest），硬編碼 skip_llm=true（不觸發 LLM triplet 抽取）。Mira 等定型貼文場景使用，本零件為 P0 必備。"
|
||||
config_example: |
|
||||
ingest_block: # 節點名稱（可自訂）
|
||||
api_key: "{{secret.kbdb_key}}"
|
||||
text: "{{previous_node.output.content}}"
|
||||
user_id: "inkstone_leo"
|
||||
source: "rss-tech-news"
|
||||
@@ -0,0 +1,3 @@
|
||||
module kbdb_ingest
|
||||
|
||||
go 1.21
|
||||
@@ -0,0 +1,155 @@
|
||||
// kbdb_ingest — 把 input 寫入 KBDB（POST /blocks/ingest）
|
||||
// thin wrapper：透過 host function http_request 呼叫 KBDB API
|
||||
//
|
||||
//go:build tinygo
|
||||
|
||||
package main
|
||||
|
||||
import (
|
||||
"encoding/json"
|
||||
"io"
|
||||
"os"
|
||||
"unsafe"
|
||||
)
|
||||
|
||||
//go:wasmimport u6u http_request
|
||||
func hostHttpRequest(
|
||||
urlPtr uintptr, urlLen uint32,
|
||||
methodPtr uintptr, methodLen uint32,
|
||||
headersPtr uintptr, headersLen uint32,
|
||||
bodyPtr uintptr, bodyLen uint32,
|
||||
outPtr uintptr, outLenPtr uintptr,
|
||||
) uint32
|
||||
|
||||
type Input struct {
|
||||
KBDBUrl string `json:"kbdb_url"` // optional, default https://kbdb.finally.click
|
||||
APIKey string `json:"api_key"` // 必填（pk_live_xxx 或 ak_xxx）
|
||||
Text string `json:"text"` // 必填（block 內容）
|
||||
UserID string `json:"user_id"` // 必填（namespace prefix 對應）
|
||||
Source string `json:"source"` // optional
|
||||
PageName string `json:"page_name"` // optional
|
||||
// 註：本零件硬編碼 skip_llm=true（mira 場景定型貼文，不需 KBDB triplet 抽取）。
|
||||
// 若需 LLM 抽取，未來另建 kbdb_ingest_with_llm 零件。
|
||||
}
|
||||
|
||||
var dummy [1]byte
|
||||
|
||||
func safePtr(b []byte) (uintptr, uint32) {
|
||||
if len(b) == 0 {
|
||||
return uintptr(unsafe.Pointer(&dummy[0])), 0
|
||||
}
|
||||
return uintptr(unsafe.Pointer(&b[0])), uint32(len(b))
|
||||
}
|
||||
|
||||
func main() {
|
||||
raw, err := io.ReadAll(os.Stdin)
|
||||
if err != nil {
|
||||
writeError("failed to read stdin: " + err.Error())
|
||||
return
|
||||
}
|
||||
|
||||
var input Input
|
||||
if err := json.Unmarshal(raw, &input); err != nil {
|
||||
writeError("invalid input JSON: " + err.Error())
|
||||
return
|
||||
}
|
||||
|
||||
if input.APIKey == "" {
|
||||
writeError("api_key 必填")
|
||||
return
|
||||
}
|
||||
if input.Text == "" {
|
||||
writeError("text 必填")
|
||||
return
|
||||
}
|
||||
if input.UserID == "" {
|
||||
writeError("user_id 必填")
|
||||
return
|
||||
}
|
||||
|
||||
kbdbURL := input.KBDBUrl
|
||||
if kbdbURL == "" {
|
||||
kbdbURL = "https://kbdb.finally.click"
|
||||
}
|
||||
|
||||
// 構造 KBDB ingest 的 body（只含 KBDB 認得的欄位）
|
||||
type ingestBody struct {
|
||||
Text string `json:"text"`
|
||||
UserID string `json:"user_id"`
|
||||
Source string `json:"source,omitempty"`
|
||||
PageName string `json:"page_name,omitempty"`
|
||||
SkipLLM *bool `json:"skip_llm,omitempty"`
|
||||
}
|
||||
skipLLM := true
|
||||
body := ingestBody{
|
||||
Text: input.Text,
|
||||
UserID: input.UserID,
|
||||
Source: input.Source,
|
||||
PageName: input.PageName,
|
||||
SkipLLM: &skipLLM,
|
||||
}
|
||||
bodyBytes, _ := json.Marshal(body)
|
||||
|
||||
headers := map[string]string{
|
||||
"Content-Type": "application/json",
|
||||
"Authorization": "Bearer " + input.APIKey,
|
||||
}
|
||||
headersBytes, _ := json.Marshal(headers)
|
||||
|
||||
url := kbdbURL + "/blocks/ingest"
|
||||
method := "POST"
|
||||
urlBytes := []byte(url)
|
||||
methodBytes := []byte(method)
|
||||
|
||||
outBuf := make([]byte, 65536)
|
||||
var outLen uint32
|
||||
|
||||
urlPtr, urlLen := safePtr(urlBytes)
|
||||
methodPtr, methodLen := safePtr(methodBytes)
|
||||
headersPtr, headersLen := safePtr(headersBytes)
|
||||
bodyPtr, bodyLenU := safePtr(bodyBytes)
|
||||
|
||||
result := hostHttpRequest(
|
||||
urlPtr, urlLen,
|
||||
methodPtr, methodLen,
|
||||
headersPtr, headersLen,
|
||||
bodyPtr, bodyLenU,
|
||||
uintptr(unsafe.Pointer(&outBuf[0])), uintptr(unsafe.Pointer(&outLen)),
|
||||
)
|
||||
|
||||
if result != 0 {
|
||||
writeError("KBDB ingest request failed (host_http_request returned non-zero)")
|
||||
return
|
||||
}
|
||||
|
||||
// KBDB 回傳格式：{"blocks_injected": N, "triplets_injected": M, ...}
|
||||
respStr := string(outBuf[:outLen])
|
||||
|
||||
// 嘗試 parse 確認是 JSON（若 KBDB 回 error 也透傳）
|
||||
var kbdbResp map[string]interface{}
|
||||
if err := json.Unmarshal([]byte(respStr), &kbdbResp); err != nil {
|
||||
writeError("KBDB returned non-JSON: " + respStr)
|
||||
return
|
||||
}
|
||||
|
||||
// 若 KBDB 回 error 欄位（401/400 etc.），透傳
|
||||
if _, hasErr := kbdbResp["error"]; hasErr {
|
||||
out, _ := json.Marshal(map[string]interface{}{
|
||||
"success": false,
|
||||
"error": kbdbResp["error"],
|
||||
})
|
||||
os.Stdout.Write(out)
|
||||
return
|
||||
}
|
||||
|
||||
out, _ := json.Marshal(map[string]interface{}{
|
||||
"success": true,
|
||||
"data": kbdbResp,
|
||||
})
|
||||
os.Stdout.Write(out)
|
||||
}
|
||||
|
||||
func writeError(msg string) {
|
||||
out, _ := json.Marshal(map[string]interface{}{"success": false, "error": msg})
|
||||
os.Stdout.Write(out)
|
||||
}
|
||||
Reference in New Issue
Block a user