core/content/author.go
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

87 lines
2.5 KiB
Go

package content
import (
"context"
"github.com/google/uuid"
)
// Author provides imperative page/post authoring for plugins (WO-WZ-019).
// The CMS implements this interface and wires it into CoreServices.
//
// These are the runtime counterparts of the idempotent seed-time operations
// on plugin.Provisioner: CreatePage is create-or-return-existing, the rest
// mutate an existing page/post. Blog posts live in the CMS's dedicated
// blog_posts table (not the pages table).
type Author interface {
CreatePage(ctx context.Context, params CreatePageParams) (CreatePageResult, error)
SetPageBlocks(ctx context.Context, pageID uuid.UUID, blocks []PageBlock) error
PublishPage(ctx context.Context, pageID uuid.UUID) error
SetPageSEO(ctx context.Context, pageID uuid.UUID, seo PageSEO) error
UpsertPost(ctx context.Context, params UpsertPostParams) (UpsertPostResult, error)
}
// CreatePageParams describes a page to create.
type CreatePageParams struct {
Slug string
ParentSlug string // "" = root
Title string
TemplateKey string
MasterPageKey string // "" = none
}
// CreatePageResult reports the created (or pre-existing) page.
type CreatePageResult struct {
PageID uuid.UUID
// Created is false when a page with the slug already existed; the
// existing ID is returned and nothing is modified.
Created bool
}
// PageBlock is one block instance placed on a page.
type PageBlock struct {
BlockKey string
Title string
Content map[string]any
HTMLContent *string
Slot string
SortOrder int32
}
// PageSEO carries the SEO fields settable on a page. Nil pointers leave the
// existing value untouched.
type PageSEO struct {
MetaTitle *string
MetaDescription *string
OGTitle *string
OGDescription *string
OGImage *string
FocusKeyphrase *string
CanonicalURL *string
RobotsDirective *string
TwitterTitle *string
TwitterDescription *string
TwitterImage *string
}
// UpsertPostParams creates or updates a blog post by slug.
type UpsertPostParams struct {
Slug string
Title string
Document map[string]any // BlockNote document
Excerpt *string
// AuthorProfileID / FeaturedImageID reference existing rows (e.g. a
// media.deposit result for the image).
AuthorProfileID *uuid.UUID
FeaturedImageID *uuid.UUID
// Publish publishes the post immediately after the upsert.
Publish bool
IsFeatured bool
}
// UpsertPostResult reports the upserted post.
type UpsertPostResult struct {
PostID uuid.UUID
Created bool
}