@deepstrike/core 0.1.10 → 0.1.12

package/index.d.ts

@@ -48,6 +48,38 @@ export interface ToolSchema {
 export interface RuntimeTask {
   goal: string
   criteria?: Array<string>
+  /** `"orchestrate"` | `"implement"` (default) | `"retrieve"` | `"verify"` */
+  lane?: string
+}
+export interface AcceptanceCriterion {
+  id: string
+  text: string
+  required: boolean
+  weight: number
+  machineCheckable: boolean
+}
+export interface VerificationContract {
+  id: string
+  goal: string
+  acceptance: Array<AcceptanceCriterion>
+  antiPatterns: Array<string>
+  evidenceRequired: Array<string>
+}
+export interface ContractCheckResult {
+  criterionId: string
+  passed: boolean
+  evidence?: string
+}
+export interface HandoffArtifact {
+  goal: string
+  sprint: number
+  progressSummary: string
+  openTasks: Array<string>
+  /** JSON-encoded context snapshot. */
+  contextSnapshot: string
+  contractStatus: Array<ContractCheckResult>
+  driftRate24H: number
+  blockedOn: Array<string>
 }
 export interface LoopPolicy {
   maxTokens: number
@@ -84,15 +116,33 @@ export interface SkillMetadata {
   effort?: number
   estimatedTokens: number
 }
+/**
+ * Structured context for a provider call — emitted with `kind === "call_llm"`.
+ * Separates system configuration from the conversation transcript so providers
+ * can map each field to their own API contract without role-filtering.
+ */
+export interface RenderedContext {
+  /**
+   * Combined system text: system partition + dashboard (when non-empty).
+   * Anthropic → `system` param · OpenAI → `messages[0]` system role ·
+   * Gemini → `systemInstruction`.
+   */
+  systemText: string
+  /**
+   * Strictly alternating user / assistant / tool turns.
+   * Working-partition signals are already folded into the first user turn.
+   */
+  turns: Array<Message>
+}
 /**
  * Discriminated union. Inspect `kind`:
- * - `"call_llm"`      → `messages`, `tools` (includes `skill` meta-tool when skills are registered)
+ * - `"call_llm"`      → `context` (RenderedContext), `tools`
  * - `"execute_tools"` → `calls`
  * - `"done"`          → `result`
  */
 export interface LoopAction {
   kind: string
-  messages?: Array<Message>
+  context?: RenderedContext
   tools?: Array<ToolSchema>
   calls?: Array<ToolCall>
   result?: LoopResult
@@ -100,12 +150,21 @@ export interface LoopAction {
 /**
  * Discriminated union for observations:
  * - `"compressed"` → `action`, `rho_after`
+ * - `"renewed"`    → `sprint`
  */
 export interface LoopObservation {
   kind: string
   action?: string
   rhoAfter?: number
+  /** Sprint number after renewal. Set when `kind === "renewed"`. */
+  sprint?: number
 }
+/**
+ * Format a VerificationContract as a markdown string suitable for injection
+ * into an agent's system prompt. The returned string is ready to pass to
+ * `LoopStateMachine.addSystemMessage()` or `LoopStateMachine.setContract()`.
+ */
+export declare function formatContractForSystemPrompt(contract: VerificationContract): string
 /** JS-friendly governance verdict returned by `Governance.evaluate`. */
 export interface GovernanceVerdict {
   /** `"allow"` | `"deny"` | `"rate_limited"` | `"ask_user"` */
@@ -210,7 +269,7 @@ export declare class ContextEngine {
    * Returns tokens saved.
    */
   compress(): number
-  render(): Array<Message>
+  render(): RenderedContext
   /**
    * Replace the available-skills set with frontmatter-only metadata.
    * The kernel will auto-inject the `skill` meta-tool into every `CallLLM` action.
@@ -246,6 +305,18 @@ export declare class LoopStateMachine {
    * `tokens` is a caller-supplied estimate; pass at least 1.
    */
   addMemoryMessage(content: string, tokens: number): void
+  /**
+   * Pre-populate the history partition with a prior transcript message.
+   * Must be called before `start`.
+   */
+  addHistoryMessage(message: Message, tokens: number): void
+  /**
+   * Inject a VerificationContract into the system partition.
+   * The contract is formatted as markdown and pushed to the `system` partition
+   * (Priority::Critical) so it survives context renewal and compression.
+   * Call before `start()`.
+   */
+  setContract(contract: VerificationContract): void
   setTools(tools: Array<ToolSchema>): void
   start(task: RuntimeTask): LoopAction
   feedLlmResponse(message: Message): LoopAction
@@ -256,7 +327,17 @@ export declare class LoopStateMachine {
   pressure(): number
   /** Drain observations emitted during the most recent feed call. */
   takeObservations(): Array<LoopObservation>
-  render(): Array<Message>
+  /**
+   * Pre-populate history with messages from a prior session.
+   * Call before `start()` to restore conversational continuity across runs.
+   */
+  preloadHistory(messages: Array<Message>): void
+  /**
+   * Return only messages added during the current run (since the last `preload_history`
+   * or construction). Use this to persist the session delta to `SessionStore.saveSession`.
+   */
+  drainNewMessages(): Array<Message>
+  render(): RenderedContext
 }
 export declare class SignalRouter {
   constructor(maxQueueSize: number)

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@deepstrike/core",
-  "version": "0.1.10",
+  "version": "0.1.12",
   "description": "DeepStrike kernel — pre-built native addon",
   "main": "index.js",
   "types": "index.d.ts",
@@ -23,12 +23,12 @@
     ]
   },
   "optionalDependencies": {
-    "@deepstrike/core-darwin-arm64": "0.1.10",
-    "@deepstrike/core-darwin-x64": "0.1.10",
-    "@deepstrike/core-linux-arm64-gnu": "0.1.10",
-    "@deepstrike/core-linux-arm64-musl": "0.1.10",
-    "@deepstrike/core-linux-x64-gnu": "0.1.10",
-    "@deepstrike/core-linux-x64-musl": "0.1.10",
-    "@deepstrike/core-win32-x64-msvc": "0.1.10"
+    "@deepstrike/core-darwin-arm64": "0.1.12",
+    "@deepstrike/core-darwin-x64": "0.1.12",
+    "@deepstrike/core-linux-arm64-gnu": "0.1.12",
+    "@deepstrike/core-linux-arm64-musl": "0.1.12",
+    "@deepstrike/core-linux-x64-gnu": "0.1.12",
+    "@deepstrike/core-linux-x64-musl": "0.1.12",
+    "@deepstrike/core-win32-x64-msvc": "0.1.12"
   }
 }