Alex Dunmow 9e39119555 feat(abi): injection-complete capability surface — provisioner family, content authoring, 4 callback hooks (WO-WZ-019)
Dynamic families added to the ABI + guest SDK:
- provisioner.* (14 methods, 1:1 plugin.Provisioner): wasm provisioning was
  silently dead (RegisterWithProvisioner got a noopProvisioner and the cms
  loader ignored has_provisioner). Now a LOAD-TIME capability via the new
  CoreServices.Provisioner field; EnsureEmbed rejects RenderFunc-only embeds.
- content.* writes (content.Author + CoreServices.ContentAuthor):
  create_page, set_page_blocks, publish_page, set_page_seo, upsert_post.
- settings.update_plugin_settings (settings.Updater grows the method).
- bridge.invoke + plugin.BridgeInvokable: opaque-payload cross-plugin calls
  (typed GetService still returns nil across the sandbox by design).
- jobs.progress: HOOK_JOB handlers' progress() now crosses (was discarded).

New host→guest hooks: HOOK_AI_TOOL_CALL (executes recorded ai.ToolDefinition
handlers — registers tools in Register so every pooled instance has them),
HOOK_BRIDGE_CALL, HOOK_DIRECTORY_PANEL_SECTION, HOOK_DIRECTORY_PIN_DECORATOR.
The ai/bridge stubs now record handlers/values locally in addition to
forwarding names.

buf breaking clean (additive within ABI major 1); golden round-trips added
for the new families (cms host replays the same goldens).

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
2026-07-04 10:02:21 +08:00

70 lines
2.1 KiB
Go

package caps
import (
"context"
"encoding/json"
abiv1 "git.dev.alexdunmow.com/block/core/abi/v1"
"git.dev.alexdunmow.com/block/core/ai"
)
// aiStub implements ai.ToolRegistry (ai.tools.register) and backs the
// CoreServices.AITextCall func field (ai.text_call).
//
// ToolDefinition.Handler stays guest-side: registration marshals only the
// static descriptor AND records the full definition locally so the host can
// execute the Handler via HOOK_AI_TOOL_CALL. Register tools in Register (every
// pooled instance runs it), not Load (one instance only) — see
// core/docs/wasm-abi.md §"Per-instance state". Instances are single-threaded,
// so the plain map needs no locking.
type aiStub struct {
base
tools map[string]*ai.ToolDefinition // slug → definition (with Handler)
}
var _ ai.ToolRegistry = (*aiStub)(nil)
// Register has no error channel; a transport failure is dropped (the host
// records nothing, matching the "best effort at load" contract).
func (s *aiStub) Register(tool *ai.ToolDefinition) {
if tool == nil {
return
}
if s.tools == nil {
s.tools = make(map[string]*ai.ToolDefinition)
}
s.tools[tool.Slug] = tool
req := &abiv1.AiToolRegisterRequest{
Slug: tool.Slug,
Name: tool.Name,
Description: tool.Description,
}
if tool.ParameterSchema != nil {
if raw, err := json.Marshal(tool.ParameterSchema); err == nil {
req.ParameterSchemaJson = raw
}
}
_ = s.invoke(context.Background(), "tools.register", req, &abiv1.AiToolRegisterResponse{})
}
// Tool returns the registered tool definition for a slug, for
// HOOK_AI_TOOL_CALL dispatch by the wasm shim.
func (s *aiStub) Tool(slug string) (*ai.ToolDefinition, bool) {
t, ok := s.tools[slug]
return t, ok
}
// textCall backs CoreServices.AITextCall.
func (s *aiStub) textCall(ctx context.Context, taskKey, systemPrompt, userMessage string) (string, error) {
req := &abiv1.AiTextCallRequest{
TaskKey: taskKey,
SystemPrompt: systemPrompt,
UserMessage: userMessage,
}
resp := &abiv1.AiTextCallResponse{}
if err := s.invoke(ctx, "text_call", req, resp); err != nil {
return "", err
}
return resp.GetText(), nil
}