Skip to content

feat(sdk,sdkx): v0.3.0 cutover — delete deprecated v0.2.x surface [skip-tag:sdk] [skip-tag:sdkx]#84

Merged
lIang70 merged 1 commit into
mainfrom
feat/sdk-v0.3.0
May 9, 2026
Merged

feat(sdk,sdkx): v0.3.0 cutover — delete deprecated v0.2.x surface [skip-tag:sdk] [skip-tag:sdkx]#84
lIang70 merged 1 commit into
mainfrom
feat/sdk-v0.3.0

Conversation

@lIang70

@lIang70 lIang70 commented May 9, 2026

Copy link
Copy Markdown
Collaborator

Summary

Closes the v0.2.x deprecation window in a single coordinated cut.
Every symbol that lived in a per-package deprecated.go shim during
v0.2.x is removed; the index files themselves are deleted. See
docs/migrations/v0.3.0.md
for the full per-symbol map.

sdk

  • Delete sdk/workflow and sdk/graph/adapter (workflow ↔ graph bridge).
  • sdk/llm: drop the RunRound / RoundStream / RoundConfig family,
    CapsMiddleware / WithExtraCaps / LookupModelCaps shims, and
    ModelInfo.Caps auto-promotion.
  • sdk/graph: collapse runner onto engine.Engine — drop the internal
    Executor interface, ErrInterrupt, WithEventBus /
    WithStreamCallback / WithCheckpointStore options, the
    busOnlyHost shim, and VarMessages / VarQuery / VarAnswer.
    Refactor llmnode.Config.MessagesKeyMessagesChannel (a pure
    typed-channel name) and remove QueryFallback. Add
    knowledgenode.Config.QueryKey.
  • sdk/engine: rename MainChannel from "" to "__main_channel"
    with a RestoreBoard migration shim for old checkpoints; reserve
    the __ prefix for engine-owned board keys.
  • sdk/knowledge: delete the v0.1 surface (Document, Chunk,
    SearchResult, SearchOptions, DocInput, Store / FSStore /
    RetrievalStore / CachedStore and their With* options,
    ChunkDocument / ScoreChunk / RankResults / RRFMerge,
    ChangeNotifier / Reloader, KnowledgeConfig / KnowledgeNode
    and the matching tools); flip ContextLayerLayer with
    ContextLayer retained as a backward-compatible alias; remove
    ModeSemantic; everything routes through *Service now.
  • sdk/history: remove Closer.Close / compactor.Close,
    SummaryCacheStore, and the RecoverArchive / SaveManifest
    top-level helpers; relocate ToolDeps / RegisterTools /
    historyExpand|Compact to sdkx/tool/history.
  • sdk/retrieval: drop SearchRequest.ReturnRaw and
    SearchResponse.RawByRetriever.
  • sdk/script/bindings: drop NewStreamBridge, NewRunBridge,
    AgentStepBindings, and the BuildEnv preset; NewRunInfoBridge
    is the surviving run-metadata bridge.
  • sdk/model: add LastByRole helper for role-scoped reverse scans
    (replaces ad-hoc loops in node code that previously coupled board
    vars to channel contents through magic keys).

sdkx

  • sdkx/tool/{history,kanban} take ownership of the relocated tool
    implementations and context keys. Public signatures stay identical
    for downstream callers that already swapped imports during the
    v0.2.x window.
  • sdkx/knowledge/watcher is removed alongside the deprecated
    ChangeNotifier. Durable watchers must produce ChangeEvent
    values for EventReloader directly.

Docs

  • Expand docs/migrations/v0.3.0.md to cover every removed symbol,
    including the additive surface accumulated across v0.2.x
    (engine.StreamRouter / Resumer / LoadAndResume, agent.Handoff,
    workspace.Capabilities, retrieval/scoring helpers, telemetry
    AttrXxx, errdefs boundary normalisation, llm image/audio caps).
  • Enable GitHub Pages from docs/ with jekyll-theme-cayman + a
    landing docs/index.md linking to the migration guide.
  • Whitelist docs/_config.yml and docs/index.md in .gitignore.

Tagging

[skip-tag:sdk] and [skip-tag:sdkx] in the title and HEAD commit
defer auto-tag deliberately. The release coordinator will hand-tag
sdk/v0.3.0 and sdkx/v0.3.0 in a coordinated cut once this PR
merges, per the schedule documented in docs/migrations/v0.3.0.md
(Timeline section).

Test plan

  • make vet — green across sdk, sdkx, vessel, voice,
    cmd/vesseld, bench, examples/voice-pipeline,
    tests/conformance, tests/quality/{knowledge,vessel},
    tests/e2e/{vesseld,retrieval}.
  • cd sdk && go test ./... — green (knowledge, history, graph,
    llm, script, engine, agent, recall, retrieval, model).
  • CI to confirm parity on Linux runners.
  • Post-merge: hand-tag sdk/v0.3.0 and sdkx/v0.3.0.

Made with Cursor

…ip-tag:sdk] [skip-tag:sdkx]

Closes the v0.2.x deprecation window in a single coordinated cut.
Every symbol that lived in a per-package deprecated.go shim during
v0.2.x is removed; the index files themselves are deleted.

sdk module:
- delete sdk/workflow and sdk/graph/adapter (workflow ↔ graph bridge)
- llm: drop RoundResult/RunRound/StreamRound/RoundConfig family,
  CapsMiddleware/WithExtraCaps/LookupModelCaps shims, ModelInfo.Caps
  auto-promotion
- graph: collapse runner onto engine.Engine — drop the internal
  Executor interface, ErrInterrupt, WithEventBus / WithStreamCallback
  / WithCheckpointStore options, busOnlyHost shim, VarMessages /
  VarQuery / VarAnswer; refactor llmnode.MessagesKey →
  MessagesChannel (typed channel name) and remove QueryFallback;
  add knowledgenode.Config.QueryKey
- engine: rename MainChannel from "" to "__main_channel" with
  RestoreBoard migration shim for old checkpoints; reserve the __
  prefix for engine-owned board keys
- knowledge: delete legacy v0.1 surface (Document/Chunk/SearchResult/
  SearchOptions/DocInput, Store/FSStore/RetrievalStore/CachedStore
  and their With* options, ChunkDocument/ScoreChunk/RankResults/
  RRFMerge, ChangeNotifier/Reloader, KnowledgeConfig/Node/* and the
  matching tools); flip ContextLayer ↔ Layer with ContextLayer kept
  as alias; remove ModeSemantic; route everything through *Service
- history: remove Closer/Compactor.Close, SummaryCacheStore,
  RecoverArchive/SaveManifest top-level helpers; relocate ToolDeps
  / RegisterTools / historyExpand|Compact tools to sdkx/tool/history
- retrieval: drop SearchRequest.ReturnRaw and
  SearchResponse.RawByRetriever
- script/bindings: drop NewStreamBridge, NewRunBridge,
  AgentStepBindings, BuildEnv preset; NewRunInfoBridge is the
  surviving run-metadata bridge
- model: add LastByRole helper for role-scoped reverse scans

sdkx module:
- sdkx/tool/{history,kanban}: take ownership of the relocated tool
  implementations and context keys; signatures stay identical for
  downstream callers that already swapped imports during v0.2.x
- sdkx/knowledge/watcher: removed alongside the deprecated
  ChangeNotifier; durable watchers must produce ChangeEvent for
  EventReloader directly

docs:
- expand docs/migrations/v0.3.0.md to cover every removed symbol,
  including the additive surface accumulated across v0.2.x
- enable GitHub Pages from docs/ with jekyll-theme-cayman + an
  index page that links to the migration guide
- whitelist docs/_config.yml and docs/index.md in .gitignore

Tagging note: skip auto-tag for both modules. Release coordinator
will hand-tag sdk/v0.3.0 and sdkx/v0.3.0 in a coordinated cut after
this PR merges.

Co-authored-by: Cursor <cursoragent@cursor.com>
@lIang70
lIang70 merged commit 5102b25 into main May 9, 2026
19 checks passed
@lIang70
lIang70 deleted the feat/sdk-v0.3.0 branch May 9, 2026 05:20
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant