@dsh-enhanced/assistant-growth-driver 0.1.34

package/lib/deposit.d.ts

@@ -0,0 +1,53 @@
+import type { GoalScope, OwnerGoalExecutionSnapshotInput } from '@dsh-enhanced/assistant-goals';
+import type { CommitOwnerAnchoredWorkflowTraceServiceResult } from '@dsh-enhanced/assistant-delivery';
+import type { GrowthOwnerScopeConfig } from './config.js';
+/**
+ * A growth authority is the Host-side analogue of RepairExecutionAuthority,
+ * but it is NOT backed by any durable repair continuation: the driver mints it
+ * from the frozen configured owner scope for exactly one bounded wake.  It can
+ * draft a pending skill candidate and nothing else.
+ */
+export interface GrowthAuthority {
+    readonly id: string;
+    readonly scope: GoalScope;
+    readonly ownerRouteId: string;
+    readonly expiresAt: number;
+    assertCurrent(): void;
+}
+export interface OwnerRouteReceipt {
+    readonly receiptVersion: 2;
+    readonly authorityId: string;
+    readonly authorityHash: string;
+    readonly principalId: string;
+    readonly principalRecordId: string;
+    readonly principalVersion: number;
+    readonly workspace: string;
+    readonly agentPreset: string;
+    readonly bindingVersion: number;
+    readonly generation: number;
+}
+export interface GrowthDeliveryPort {
+    validateOwnerRoute(input: {
+        authorityId: string;
+        principalId: string;
+        workspace: string;
+        agentPreset: string;
+    }): Readonly<OwnerRouteReceipt>;
+    /**
+     * Host-only owner-anchored learning seam. The driver passes only a locator
+     * and the bounded-wake authority; Delivery re-fetches the verified Goals
+     * source and run proof itself and never accepts a caller-supplied prompt.
+     */
+    commitOwnerAnchoredWorkflowTrace(input: Readonly<{
+        locator: OwnerGoalExecutionSnapshotInput;
+        authority: GrowthAuthority;
+    }>): Promise<Readonly<CommitOwnerAnchoredWorkflowTraceServiceResult>>;
+}
+/**
+ * Re-anchor the configured owner scope against the live authenticated Delivery
+ * owner route and mint one short-lived growth authority.  Never derives an
+ * owner from model-controlled values: the route id, principal, workspace and
+ * preset all come from frozen plugin configuration.
+ */
+export declare function mintGrowthAuthority(delivery: GrowthDeliveryPort, config: GrowthOwnerScopeConfig, expiresAt: number): GrowthAuthority;
+//# sourceMappingURL=deposit.d.ts.map

package/lib/deposit.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"deposit.d.ts","sourceRoot":"","sources":["../src/deposit.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,SAAS,EAAE,+BAA+B,EAAE,MAAM,+BAA+B,CAAA;AAC/F,OAAO,KAAK,EAAE,6CAA6C,EAAE,MAAM,kCAAkC,CAAA;AACrG,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,aAAa,CAAA;AAEzD;;;;;GAKG;AACH,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAA;IACnB,QAAQ,CAAC,KAAK,EAAE,SAAS,CAAA;IACzB,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAA;IAC7B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAA;IAC1B,aAAa,IAAI,IAAI,CAAA;CACtB;AAED,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,cAAc,EAAE,CAAC,CAAA;IAC1B,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAA;IAC5B,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAA;IAC9B,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAA;IAC5B,QAAQ,CAAC,iBAAiB,EAAE,MAAM,CAAA;IAClC,QAAQ,CAAC,gBAAgB,EAAE,MAAM,CAAA;IACjC,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAA;IAC1B,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAA;IAC5B,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAA;IAC/B,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAA;CAC5B;AAED,MAAM,WAAW,kBAAkB;IACjC,kBAAkB,CAAC,KAAK,EAAE;QACxB,WAAW,EAAE,MAAM,CAAA;QACnB,WAAW,EAAE,MAAM,CAAA;QACnB,SAAS,EAAE,MAAM,CAAA;QACjB,WAAW,EAAE,MAAM,CAAA;KACpB,GAAG,QAAQ,CAAC,iBAAiB,CAAC,CAAA;IAC/B;;;;OAIG;IACH,gCAAgC,CAAC,KAAK,EAAE,QAAQ,CAAC;QAC/C,OAAO,EAAE,+BAA+B,CAAA;QACxC,SAAS,EAAE,eAAe,CAAA;KAC3B,CAAC,GAAG,OAAO,CAAC,QAAQ,CAAC,6CAA6C,CAAC,CAAC,CAAA;CACtE;AAED;;;;;GAKG;AACH,wBAAgB,mBAAmB,CAAC,QAAQ,EAAE,kBAAkB,EAAE,MAAM,EAAE,sBAAsB,EAAE,SAAS,EAAE,MAAM,GAAG,eAAe,CA6CpI"}

package/lib/deposit.js

@@ -0,0 +1,55 @@
+import { createHash } from 'node:crypto';
+import { acceptanceDigest } from '@dsh-enhanced/task-acceptance-contract';
+/**
+ * Re-anchor the configured owner scope against the live authenticated Delivery
+ * owner route and mint one short-lived growth authority.  Never derives an
+ * owner from model-controlled values: the route id, principal, workspace and
+ * preset all come from frozen plugin configuration.
+ */
+export function mintGrowthAuthority(delivery, config, expiresAt) {
+    const anchor = delivery.validateOwnerRoute({
+        authorityId: config.ownerRouteId,
+        principalId: config.principalId,
+        workspace: config.workspace,
+        agentPreset: config.preset,
+    });
+    if (anchor.principalId !== config.principalId || anchor.workspace !== config.workspace
+        || anchor.agentPreset !== config.preset || anchor.authorityId !== config.ownerRouteId) {
+        throw new Error('assistant-growth-driver: owner route receipt does not match the configured scope');
+    }
+    const scope = Object.freeze({
+        principalId: config.principalId,
+        principalRecordId: anchor.principalRecordId,
+        principalVersion: anchor.principalVersion,
+        workspace: config.workspace,
+        preset: config.preset,
+    });
+    const anchorDigest = acceptanceDigest(anchor);
+    const id = `growth-${createHash('sha256')
+        .update(acceptanceDigest({ scope, ownerRouteId: config.ownerRouteId, expiresAt, anchorDigest }))
+        .digest('hex')
+        .slice(0, 40)}`;
+    return Object.freeze({
+        id,
+        scope,
+        ownerRouteId: config.ownerRouteId,
+        expiresAt,
+        assertCurrent() {
+            if (!Number.isSafeInteger(expiresAt) || expiresAt <= Date.now()) {
+                throw new Error('assistant-growth-driver: growth authority expired');
+            }
+            // Re-read the owner route on every use: a revoked/rebound delivery route
+            // or a principal generation change invalidates the whole wake.
+            const current = delivery.validateOwnerRoute({
+                authorityId: config.ownerRouteId,
+                principalId: config.principalId,
+                workspace: config.workspace,
+                agentPreset: config.preset,
+            });
+            if (acceptanceDigest(current) !== anchorDigest) {
+                throw new Error('assistant-growth-driver: owner route changed during growth wake');
+            }
+        },
+    });
+}
+//# sourceMappingURL=deposit.js.map

package/lib/deposit.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"deposit.js","sourceRoot":"","sources":["../src/deposit.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAA;AACxC,OAAO,EAAE,gBAAgB,EAAE,MAAM,wCAAwC,CAAA;AAkDzE;;;;;GAKG;AACH,MAAM,UAAU,mBAAmB,CAAC,QAA4B,EAAE,MAA8B,EAAE,SAAiB;IACjH,MAAM,MAAM,GAAG,QAAQ,CAAC,kBAAkB,CAAC;QACzC,WAAW,EAAE,MAAM,CAAC,YAAY;QAChC,WAAW,EAAE,MAAM,CAAC,WAAW;QAC/B,SAAS,EAAE,MAAM,CAAC,SAAS;QAC3B,WAAW,EAAE,MAAM,CAAC,MAAM;KAC3B,CAAC,CAAA;IACF,IAAI,MAAM,CAAC,WAAW,KAAK,MAAM,CAAC,WAAW,IAAI,MAAM,CAAC,SAAS,KAAK,MAAM,CAAC,SAAS;WACjF,MAAM,CAAC,WAAW,KAAK,MAAM,CAAC,MAAM,IAAI,MAAM,CAAC,WAAW,KAAK,MAAM,CAAC,YAAY,EAAE,CAAC;QACxF,MAAM,IAAI,KAAK,CAAC,kFAAkF,CAAC,CAAA;IACrG,CAAC;IACD,MAAM,KAAK,GAAc,MAAM,CAAC,MAAM,CAAC;QACrC,WAAW,EAAE,MAAM,CAAC,WAAW;QAC/B,iBAAiB,EAAE,MAAM,CAAC,iBAAiB;QAC3C,gBAAgB,EAAE,MAAM,CAAC,gBAAgB;QACzC,SAAS,EAAE,MAAM,CAAC,SAAS;QAC3B,MAAM,EAAE,MAAM,CAAC,MAAM;KACtB,CAAC,CAAA;IACF,MAAM,YAAY,GAAG,gBAAgB,CAAC,MAAM,CAAC,CAAA;IAC7C,MAAM,EAAE,GAAG,UAAU,UAAU,CAAC,QAAQ,CAAC;SACtC,MAAM,CAAC,gBAAgB,CAAC,EAAE,KAAK,EAAE,YAAY,EAAE,MAAM,CAAC,YAAY,EAAE,SAAS,EAAE,YAAY,EAAE,CAAC,CAAC;SAC/F,MAAM,CAAC,KAAK,CAAC;SACb,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,EAAE,CAAA;IACjB,OAAO,MAAM,CAAC,MAAM,CAAC;QACnB,EAAE;QACF,KAAK;QACL,YAAY,EAAE,MAAM,CAAC,YAAY;QACjC,SAAS;QACT,aAAa;YACX,IAAI,CAAC,MAAM,CAAC,aAAa,CAAC,SAAS,CAAC,IAAI,SAAS,IAAI,IAAI,CAAC,GAAG,EAAE,EAAE,CAAC;gBAChE,MAAM,IAAI,KAAK,CAAC,mDAAmD,CAAC,CAAA;YACtE,CAAC;YACD,yEAAyE;YACzE,+DAA+D;YAC/D,MAAM,OAAO,GAAG,QAAQ,CAAC,kBAAkB,CAAC;gBAC1C,WAAW,EAAE,MAAM,CAAC,YAAY;gBAChC,WAAW,EAAE,MAAM,CAAC,WAAW;gBAC/B,SAAS,EAAE,MAAM,CAAC,SAAS;gBAC3B,WAAW,EAAE,MAAM,CAAC,MAAM;aAC3B,CAAC,CAAA;YACF,IAAI,gBAAgB,CAAC,OAAO,CAAC,KAAK,YAAY,EAAE,CAAC;gBAC/C,MAAM,IAAI,KAAK,CAAC,iEAAiE,CAAC,CAAA;YACpF,CAAC;QACH,CAAC;KACF,CAAC,CAAA;AACJ,CAAC"}

package/lib/growth-agent.d.ts

@@ -0,0 +1,63 @@
+import type { Context } from '@deepseek-ai/cordis';
+import { type ModelSelection } from '@deepseek-ai/dsh-agent';
+import type { AssistantGoalsService } from '@dsh-enhanced/assistant-goals';
+import type { AssistantSkillsService } from '@dsh-enhanced/assistant-skills';
+import type { NormalizedGrowthDriverConfig } from './config.js';
+import type { GrowthAuthority } from './deposit.js';
+import { type GrowthSourcePlanePort } from './source-port.js';
+export declare const GROWTH_PROMPT: string;
+/**
+ * Extra prompt section mounted ONLY when the owner opted into
+ * pluginSourceProposals. It defines the three source tools and the hard
+ * boundaries around the isolated modify lane.
+ */
+export declare const SOURCE_PROPOSALS_PROMPT: string;
+export interface GrowthSourceWakeCounters {
+    readonly queued: number;
+    readonly prepared: number;
+    readonly rejected: number;
+}
+export interface GrowthAgentRunResult {
+    readonly model: Readonly<ModelSelection>;
+    readonly sessionId: string;
+    readonly outcome: 'succeeded' | 'cancelled' | 'failed' | 'unknown';
+    readonly output: string;
+    readonly usage: {
+        inputTokens: number;
+        outputTokens: number;
+        cacheReadTokens: number;
+        cacheWriteTokens: number;
+        reasoningTokens: number;
+        modelCalls: number;
+        toolCalls: number;
+    };
+    /** Zeroed unless the owner opted into pluginSourceProposals and a source port is bound. */
+    readonly sourceProposals: GrowthSourceWakeCounters;
+}
+type Goals = Pick<AssistantGoalsService, 'inspectOwnerGoals' | 'inspectOwnerVerifiedWorkflowSource'>;
+type Skills = Pick<AssistantSkillsService, 'inspectOwnerActiveSkills' | 'inspectOwnerSkillCandidates' | 'stageOwnerVerifiedSuccessCandidate'>;
+export interface GrowthAgentInput {
+    wakeId: string;
+    authority: GrowthAuthority;
+    config: NormalizedGrowthDriverConfig;
+    model: Readonly<ModelSelection>;
+    goals: Goals;
+    skills: Skills;
+    /**
+     * Bound ONLY when pluginSourceProposals is enabled AND a pluginControlPlane
+     * service is mounted. When undefined, the three source tools are not registered
+     * and the exact-surface contract is the frozen four-tool baseline.
+     */
+    sourcePlane?: GrowthSourcePlanePort;
+    signal?: AbortSignal;
+    /** Actual task context is data, never authority or independent success proof. */
+    feedback?: import('@dsh-enhanced/assistant-delivery').OwnerForegroundLearningTask;
+}
+/**
+ * Create, run to idle and dispose exactly one bounded growth agent.  Never
+ * mounts a preset: the complete tool surface is the four growth_* realm tools,
+ * and any extra visible tool fails closed before the prompt is submitted.
+ */
+export declare function runGrowthAgent(ctx: Context, input: GrowthAgentInput): Promise<GrowthAgentRunResult>;
+export {};
+//# sourceMappingURL=growth-agent.d.ts.map

package/lib/growth-agent.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"growth-agent.d.ts","sourceRoot":"","sources":["../src/growth-agent.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAA;AAClD,OAAO,EAAuD,KAAK,cAAc,EAAE,MAAM,wBAAwB,CAAA;AAKjH,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,+BAA+B,CAAA;AAE1E,OAAO,KAAK,EAAE,sBAAsB,EAAgB,MAAM,gCAAgC,CAAA;AAC1F,OAAO,KAAK,EAAE,4BAA4B,EAAE,MAAM,aAAa,CAAA;AAC/D,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,cAAc,CAAA;AACnD,OAAO,EAEL,KAAK,qBAAqB,EAG3B,MAAM,kBAAkB,CAAA;AAmCzB,eAAO,MAAM,aAAa,QAed,CAAA;AAEZ;;;;GAIG;AACH,eAAO,MAAM,uBAAuB,QAgBxB,CAAA;AAEZ,MAAM,WAAW,wBAAwB;IACvC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;IACvB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAA;IACzB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAA;CAC1B;AAED,MAAM,WAAW,oBAAoB;IACnC,QAAQ,CAAC,KAAK,EAAE,QAAQ,CAAC,cAAc,CAAC,CAAA;IACxC,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAA;IAC1B,QAAQ,CAAC,OAAO,EAAE,WAAW,GAAG,WAAW,GAAG,QAAQ,GAAG,SAAS,CAAA;IAClE,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;IACvB,QAAQ,CAAC,KAAK,EAAE;QACd,WAAW,EAAE,MAAM,CAAA;QACnB,YAAY,EAAE,MAAM,CAAA;QACpB,eAAe,EAAE,MAAM,CAAA;QACvB,gBAAgB,EAAE,MAAM,CAAA;QACxB,eAAe,EAAE,MAAM,CAAA;QACvB,UAAU,EAAE,MAAM,CAAA;QAClB,SAAS,EAAE,MAAM,CAAA;KAClB,CAAA;IACD,2FAA2F;IAC3F,QAAQ,CAAC,eAAe,EAAE,wBAAwB,CAAA;CACnD;AAED,KAAK,KAAK,GAAG,IAAI,CAAC,qBAAqB,EAAE,mBAAmB,GAAG,oCAAoC,CAAC,CAAA;AACpG,KAAK,MAAM,GAAG,IAAI,CAAC,sBAAsB,EAAE,0BAA0B,GAAG,6BAA6B,GAAG,oCAAoC,CAAC,CAAA;AAG7I,MAAM,WAAW,gBAAgB;IAC/B,MAAM,EAAE,MAAM,CAAA;IACd,SAAS,EAAE,eAAe,CAAA;IAC1B,MAAM,EAAE,4BAA4B,CAAA;IACpC,KAAK,EAAE,QAAQ,CAAC,cAAc,CAAC,CAAA;IAC/B,KAAK,EAAE,KAAK,CAAA;IACZ,MAAM,EAAE,MAAM,CAAA;IACd;;;;OAIG;IACH,WAAW,CAAC,EAAE,qBAAqB,CAAA;IACnC,MAAM,CAAC,EAAE,WAAW,CAAA;IACpB,iFAAiF;IACjF,QAAQ,CAAC,EAAE,OAAO,kCAAkC,EAAE,2BAA2B,CAAA;CAClF;AAyVD;;;;GAIG;AACH,wBAAsB,cAAc,CAAC,GAAG,EAAE,OAAO,EAAE,KAAK,EAAE,gBAAgB,GAAG,OAAO,CAAC,oBAAoB,CAAC,CA8HzG"}