@consciousclouds/conductor-sdk 0.1.0 → 0.1.1
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/CHANGELOG.md +17 -0
- package/dist/generated/types.d.ts +29 -3
- package/dist/generated/types.d.ts.map +1 -1
- package/package.json +1 -1
package/CHANGELOG.md
CHANGED
|
@@ -2,6 +2,23 @@
|
|
|
2
2
|
|
|
3
3
|
Versioned on the independent frontend-SDK lifecycle (NOT `contract_version`).
|
|
4
4
|
|
|
5
|
+
## [0.1.1]
|
|
6
|
+
|
|
7
|
+
### Added
|
|
8
|
+
|
|
9
|
+
- Generated request types gain four optional fields, all inert and advisory to existing callers:
|
|
10
|
+
`TurnRequest.context` (`TurnRequestContext`: `location`, `scope`, `workspace` and `engagement`, a
|
|
11
|
+
`TurnRequestContextEngagement` of `kind` and `id`), `TurnRequest.conversation_id`,
|
|
12
|
+
`PersonalityDeclaration.knowledge_namespaces` and `PersonalityDeclaration.routes`.
|
|
13
|
+
|
|
14
|
+
### Changed
|
|
15
|
+
|
|
16
|
+
- `PersonalityDeclaration.classification` (regenerated from the v1 contract) now admits the canonical ADR-39
|
|
17
|
+
AI-Layer tiers `platform` · `domain-personality` · `consumer`. `operator` and `developer` · `administrator` ·
|
|
18
|
+
`analyst` · `educator` remain in the v1 union so declarations already authored against it stay readable, and are
|
|
19
|
+
documented as deprecated: the runtime admits `operator` only at the declaration-file ingress for the ADR-39 window
|
|
20
|
+
and refuses the other four (migration required).
|
|
21
|
+
|
|
5
22
|
## [0.1.0] — 2026-06-16
|
|
6
23
|
|
|
7
24
|
### Added
|
|
@@ -1,11 +1,33 @@
|
|
|
1
1
|
/** A capability string in the `<primitive>.<verb>` vocabulary, e.g. canvas.read. */
|
|
2
2
|
export type Capability = string;
|
|
3
|
-
/**
|
|
3
|
+
/** What the operator is engaged with — the object of their attention. */
|
|
4
|
+
export interface TurnRequestContextEngagement {
|
|
5
|
+
/** A product noun (deployment, trace, sdk, …). */
|
|
6
|
+
kind?: string;
|
|
7
|
+
/** The engaged object's id. */
|
|
8
|
+
id?: string;
|
|
9
|
+
}
|
|
10
|
+
/** The operator's operational context — where they are and what they're engaged with. Inert and advisory: composed into the instruction as a content-blind slot, never authority. Mirrors the shell's TurnContext. */
|
|
11
|
+
export interface TurnRequestContext {
|
|
12
|
+
/** Where the operator is (today a route/URL; deliberately broader than 'route'). */
|
|
13
|
+
location?: string;
|
|
14
|
+
/** The active project/product scope reference (e.g. 'ccu-admin'). */
|
|
15
|
+
scope?: string;
|
|
16
|
+
/** The active workspace id, if any. */
|
|
17
|
+
workspace?: string;
|
|
18
|
+
/** What the operator is engaged with — the object of their attention. */
|
|
19
|
+
engagement?: TurnRequestContextEngagement;
|
|
20
|
+
}
|
|
21
|
+
/** Request body for POST /api/v1/conductor/turn/stream. The caller supplies a prompt and an optional personality id; when omitted the server selects its default personality. `context` and `conversation_id` are INERT, ADVISORY inputs (the same class as the prompt): never authority, never identity, never a scope decision. */
|
|
4
22
|
export interface TurnRequest {
|
|
5
23
|
/** Id of the registered personality to drive the turn. Optional; defaults server-side. */
|
|
6
24
|
personality_id?: string;
|
|
7
25
|
/** The user prompt for this turn. */
|
|
8
26
|
prompt: string;
|
|
27
|
+
/** The operator's operational context — where they are and what they're engaged with. Inert and advisory: composed into the instruction as a content-blind slot, never authority. Mirrors the shell's TurnContext. */
|
|
28
|
+
context?: TurnRequestContext;
|
|
29
|
+
/** The conversation correlation id (UUID) this turn belongs to — the durable thread's grouping key (Session Binder, docs/design/session-binder.md). Inert and advisory: shell-minted-or-adopted, forwarded verbatim, NEVER authority. Absent ⇒ the turn is recorded unattributed to any thread. */
|
|
30
|
+
conversation_id?: string;
|
|
9
31
|
}
|
|
10
32
|
/** Request body for POST /api/v1/conductor/approvals/:id/resolve. Approves or rejects a pending approval surfaced by an approval_required SSE event. */
|
|
11
33
|
export interface ResolveRequest {
|
|
@@ -72,8 +94,8 @@ export interface PersonalityDeclaration {
|
|
|
72
94
|
description: string;
|
|
73
95
|
/** The vertical this personality ships in (Business Package Contract link). */
|
|
74
96
|
business_package: string;
|
|
75
|
-
/**
|
|
76
|
-
classification?: "
|
|
97
|
+
/** The AI-Layer tier (optional): platform · domain-personality · consumer (ADR-39, canonical). Load-bearing — it sets the trace read scope, the episode classification, and Chief's wake self-suppression. DEPRECATED (v1 keeps them so declarations already authored against it stay readable): `operator` is accepted only at the declaration-file ingress for the bounded ADR-39 window — author `platform` (the ecosystem operator) or `domain-personality` (a product operator) instead; `developer` · `administrator` · `analyst` · `educator` have no canonical mapping and the runtime refuses them (migration required). */
|
|
98
|
+
classification?: "platform" | "domain-personality" | "consumer" | "operator" | "developer" | "administrator" | "analyst" | "educator";
|
|
77
99
|
/** System instructions / persona; opaque to the engine. */
|
|
78
100
|
instructions: string;
|
|
79
101
|
/** Model-tier hint; never a vendor/model id. */
|
|
@@ -92,6 +114,8 @@ export interface PersonalityDeclaration {
|
|
|
92
114
|
allowed_graph_scopes?: string[];
|
|
93
115
|
/** Memory scopes the personality may read/write. Forward-declared; firmed up by the Memory SDK lock; project_id-gated. */
|
|
94
116
|
allowed_memory_scopes?: string[];
|
|
117
|
+
/** The document/vector namespaces the knowledge_search tool may query for this personality. A product grants its OWN document namespace here, so its AI searches its docs without a Universal edit (the retrieval tool is generic, scoped per-personality). */
|
|
118
|
+
knowledge_namespaces?: string[];
|
|
95
119
|
/** BEHAVIOR-ONLY surface config. Styling/branding/appearance stays in the product. */
|
|
96
120
|
assistant_surface_config?: PersonalityDeclarationAssistantSurfaceConfig;
|
|
97
121
|
/** Presentation posture (behavior-only): chat-first or canvas-first. The AI Client arranges the surface accordingly. Default chat-first. */
|
|
@@ -106,6 +130,8 @@ export interface PersonalityDeclaration {
|
|
|
106
130
|
usage_policy?: PersonalityDeclarationUsagePolicy;
|
|
107
131
|
/** Audit posture (declared now, enforced as auditing matures). */
|
|
108
132
|
audit_policy?: PersonalityDeclarationAuditPolicy;
|
|
133
|
+
/** Response Routing (decision) — ordered deterministic route table. Decided BEFORE any model call (docs/design/response-decision-presentation-routing.md). Optional + additive: no routes = pure-LLM. First match wins; no match escalates to the model. A route never names a product or personality. */
|
|
134
|
+
routes?: Record<string, unknown>[];
|
|
109
135
|
}
|
|
110
136
|
/** The pending tool call awaiting approval. */
|
|
111
137
|
export interface ApprovalRequiredEventDataPending {
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/generated/types.ts"],"names":[],"mappings":"AAKA,oFAAoF;AACpF,MAAM,MAAM,UAAU,GAAG,MAAM,CAAC;AAGhC,
|
|
1
|
+
{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/generated/types.ts"],"names":[],"mappings":"AAKA,oFAAoF;AACpF,MAAM,MAAM,UAAU,GAAG,MAAM,CAAC;AAGhC,yEAAyE;AACzE,MAAM,WAAW,4BAA4B;IAC3C,kDAAkD;IAClD,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,+BAA+B;IAC/B,EAAE,CAAC,EAAE,MAAM,CAAC;CACb;AAED,sNAAsN;AACtN,MAAM,WAAW,kBAAkB;IACjC,oFAAoF;IACpF,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,qEAAqE;IACrE,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,uCAAuC;IACvC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,yEAAyE;IACzE,UAAU,CAAC,EAAE,4BAA4B,CAAC;CAC3C;AAED,qUAAqU;AACrU,MAAM,WAAW,WAAW;IAC1B,0FAA0F;IAC1F,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,qCAAqC;IACrC,MAAM,EAAE,MAAM,CAAC;IACf,sNAAsN;IACtN,OAAO,CAAC,EAAE,kBAAkB,CAAC;IAC7B,mSAAmS;IACnS,eAAe,CAAC,EAAE,MAAM,CAAC;CAC1B;AAED,wJAAwJ;AACxJ,MAAM,WAAW,cAAc;IAC7B,wDAAwD;IACxD,QAAQ,EAAE,SAAS,GAAG,QAAQ,CAAC;CAChC;AAED,sEAAsE;AACtE,MAAM,WAAW,aAAa;IAC5B,4CAA4C;IAC5C,WAAW,EAAE,MAAM,CAAC;IACpB,yCAAyC;IACzC,MAAM,EAAE,MAAM,CAAC;IACf,2CAA2C;IAC3C,IAAI,EAAE,MAAM,CAAC;IACb,+DAA+D;IAC/D,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC;IACvC,2DAA2D;IAC3D,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,+MAA+M;AAC/M,MAAM,WAAW,eAAe;IAC9B,wBAAwB;IACxB,IAAI,EAAE,MAAM,CAAC;IACb,wDAAwD;IACxD,WAAW,EAAE,MAAM,CAAC;IACpB,yDAAyD;IACzD,YAAY,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACtC,yCAAyC;IACzC,QAAQ,EAAE,MAAM,GAAG,OAAO,GAAG,aAAa,CAAC;IAC3C,4DAA4D;IAC5D,qBAAqB,EAAE,MAAM,EAAE,CAAC;IAChC,iEAAiE;IACjE,iBAAiB,EAAE,OAAO,CAAC;IAC3B,+CAA+C;IAC/C,UAAU,EAAE,OAAO,CAAC;CACrB;AAED,sFAAsF;AACtF,MAAM,WAAW,4CAA4C;IAC3D,IAAI,CAAC,EAAE,SAAS,GAAG,QAAQ,CAAC;IAC5B,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB;AAED,oDAAoD;AACpD,MAAM,WAAW,oCAAoC;IACnD,sDAAsD;IACtD,sBAAsB,CAAC,EAAE,MAAM,EAAE,CAAC;CACnC;AAED,4FAA4F;AAC5F,MAAM,WAAW,iCAAiC;IAChD,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,mBAAmB,CAAC,EAAE,MAAM,CAAC;CAC9B;AAED,kEAAkE;AAClE,MAAM,WAAW,iCAAiC;IAChD,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,6UAA6U;AAC7U,MAAM,WAAW,sBAAsB;IACrC,8EAA8E;IAC9E,EAAE,EAAE,MAAM,CAAC;IACX,0BAA0B;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,wBAAwB;IACxB,WAAW,EAAE,MAAM,CAAC;IACpB,+EAA+E;IAC/E,gBAAgB,EAAE,MAAM,CAAC;IACzB,qmBAAqmB;IACrmB,cAAc,CAAC,EAAE,UAAU,GAAG,oBAAoB,GAAG,UAAU,GAAG,UAAU,GAAG,WAAW,GAAG,eAAe,GAAG,SAAS,GAAG,UAAU,CAAC;IACtI,2DAA2D;IAC3D,YAAY,EAAE,MAAM,CAAC;IACrB,gDAAgD;IAChD,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC;IAChC,6KAA6K;IAC7K,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,qHAAqH;IACrH,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB,0EAA0E;IAC1E,aAAa,EAAE,MAAM,EAAE,CAAC;IACxB,iGAAiG;IACjG,gBAAgB,EAAE,MAAM,EAAE,CAAC;IAC3B,wEAAwE;IACxE,gBAAgB,EAAE,MAAM,EAAE,CAAC;IAC3B,gGAAgG;IAChG,oBAAoB,CAAC,EAAE,MAAM,EAAE,CAAC;IAChC,0HAA0H;IAC1H,qBAAqB,CAAC,EAAE,MAAM,EAAE,CAAC;IACjC,+PAA+P;IAC/P,oBAAoB,CAAC,EAAE,MAAM,EAAE,CAAC;IAChC,sFAAsF;IACtF,wBAAwB,CAAC,EAAE,4CAA4C,CAAC;IACxE,4IAA4I;IAC5I,eAAe,CAAC,EAAE,YAAY,GAAG,cAAc,CAAC;IAChD,mEAAmE;IACnE,oBAAoB,CAAC,EAAE,MAAM,EAAE,CAAC;IAChC,gEAAgE;IAChE,iBAAiB,CAAC,EAAE,MAAM,EAAE,CAAC;IAC7B,oDAAoD;IACpD,eAAe,CAAC,EAAE,oCAAoC,CAAC;IACvD,4FAA4F;IAC5F,YAAY,CAAC,EAAE,iCAAiC,CAAC;IACjD,kEAAkE;IAClE,YAAY,CAAC,EAAE,iCAAiC,CAAC;IACjD,0SAA0S;IAC1S,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,CAAC;CACpC;AAGD,+CAA+C;AAC/C,MAAM,WAAW,gCAAgC;IAC/C,kCAAkC;IAClC,YAAY,EAAE,MAAM,CAAC;IACrB,0CAA0C;IAC1C,IAAI,EAAE,MAAM,CAAC;CACd;AAED,+GAA+G;AAC/G,MAAM,WAAW,yBAAyB;IACxC,wCAAwC;IACxC,OAAO,EAAE,MAAM,CAAC;IAChB,uCAAuC;IACvC,WAAW,EAAE,MAAM,CAAC;IACpB,+CAA+C;IAC/C,OAAO,EAAE,gCAAgC,CAAC;CAC3C;AAED,8GAA8G;AAC9G,MAAM,WAAW,kBAAkB;IACjC,gCAAgC;IAChC,OAAO,EAAE,MAAM,CAAC;IAChB,kDAAkD;IAClD,KAAK,EAAE,MAAM,CAAC;IACd,iDAAiD;IACjD,UAAU,EAAE,MAAM,CAAC;IACnB,6BAA6B;IAC7B,YAAY,EAAE,MAAM,CAAC;IACrB,8BAA8B;IAC9B,aAAa,EAAE,MAAM,CAAC;IACtB,qCAAqC;IACrC,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,sFAAsF;AACtF,MAAM,WAAW,cAAc;IAC7B,kCAAkC;IAClC,IAAI,EAAE,MAAM,CAAC;CACd;AAED,iFAAiF;AACjF,MAAM,WAAW,cAAc;IAC7B,mCAAmC;IACnC,IAAI,EAAE,MAAM,CAAC;IACb,oCAAoC;IACpC,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,wVAAwV;AACxV,MAAM,WAAW,eAAe;IAC9B,4EAA4E;IAC5E,IAAI,EAAE,YAAY,GAAG,QAAQ,CAAC;IAC9B,gHAAgH;IAChH,MAAM,EAAE,MAAM,CAAC;IACf,gHAAgH;IAChH,IAAI,EAAE,UAAU,GAAG,WAAW,GAAG,aAAa,CAAC;IAC/C,+CAA+C;IAC/C,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACjC,uEAAuE;IACvE,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAED,qFAAqF;AACrF,MAAM,WAAW,gBAAgB;IAC/B,wCAAwC;IACxC,OAAO,EAAE,MAAM,CAAC;IAChB,sCAAsC;IACtC,WAAW,EAAE,MAAM,CAAC;IACpB,wCAAwC;IACxC,IAAI,EAAE,MAAM,CAAC;CACd;AAED,4EAA4E;AAC5E,MAAM,WAAW,iBAAiB;IAChC,sCAAsC;IACtC,IAAI,EAAE,MAAM,CAAC;IACb,gDAAgD;IAChD,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,uCAAuC;IACvC,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,6LAA6L;IAC7L,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,0EAA0E;AAC1E,MAAM,WAAW,kBAAkB;IACjC,sCAAsC;IACtC,IAAI,EAAE,MAAM,CAAC;IACb,gDAAgD;IAChD,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,uCAAuC;IACvC,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAGD,kCAAkC;AAClC,MAAM,MAAM,kBAAkB,GAAG,SAAS,GAAG,OAAO,GAAG,YAAY,GAAG,WAAW,GAAG,mBAAmB,GAAG,WAAW,GAAG,OAAO,GAAG,QAAQ,CAAC;AAE3I,iDAAiD;AACjD,MAAM,WAAW,qBAAqB;IACpC,OAAO,EAAE,gBAAgB,CAAC;IAC1B,KAAK,EAAE,cAAc,CAAC;IACtB,UAAU,EAAE,kBAAkB,CAAC;IAC/B,SAAS,EAAE,iBAAiB,CAAC;IAC7B,iBAAiB,EAAE,yBAAyB,CAAC;IAC7C,SAAS,EAAE,kBAAkB,CAAC;IAC9B,KAAK,EAAE,cAAc,CAAC;IACtB,MAAM,EAAE,eAAe,CAAC;CACzB"}
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@consciousclouds/conductor-sdk",
|
|
3
|
-
"version": "0.1.
|
|
3
|
+
"version": "0.1.1",
|
|
4
4
|
"description": "Conscious Clouds Conductor SDK — TurnRequest/SSE event/approval types, tool + personality + capability declaration types, and a thin Conductor client (streaming turn + approval resolve). Framework-agnostic, provider-agnostic. baseUrl is a configurable Conductor-compatible endpoint; the SDK never mints identity and never hard-codes a gateway URL.",
|
|
5
5
|
"license": "Apache-2.0",
|
|
6
6
|
"type": "module",
|