@gajae-code/coding-agent 0.3.1 → 0.4.0

package/dist/types/sdk.d.ts

@@ -49,6 +49,13 @@ export interface CreateAgentSessionOptions {
     providerSessionId?: string;
     /** Custom tools to register (in addition to built-in tools). Accepts both CustomTool and ToolDefinition. */
     customTools?: (CustomTool | ToolDefinition)[];
+    /** Explicit parent/phase used to load active GJC sub-skill tools for this session. */
+    gjcSubskillToolContext?: {
+        parent: string;
+        phase: string;
+        sessionId?: string;
+        cwd?: string;
+    };
     /** Inline extensions (merged with discovery). */
     extensions?: ExtensionFactory[];
     /** Additional extension paths to load (merged with discovery). */
@@ -95,7 +102,7 @@ export interface CreateAgentSessionOptions {
     taskDepth?: number;
     /** Current role-agent type/name for nested task sessions. */
     currentAgentType?: string;
-    /** Parent Hindsight state to alias for subagent memory tools. */
+    /** Parent Hindsight state to alias for subagent private memory backend compatibility. */
     parentHindsightSessionState?: HindsightSessionState;
     /** Pre-allocated agent identity for IRC routing. Default: "0-Main" for top-level, parentTaskPrefix-derived for sub. */
     agentId?: string;

package/dist/types/session/agent-session.d.ts

@@ -57,11 +57,13 @@ import { type FileSlashCommand } from "../extensibility/slash-commands";
 import { GoalRuntime } from "../goals/runtime";
 import type { Goal, GoalModeState } from "../goals/state";
 import type { HindsightSessionState } from "../hindsight/state";
+import type { WorkflowGateEmitter } from "../modes/shared/agent-wire/unattended-session";
 import type { PlanModeState } from "../plan-mode/state";
 import { type AgentRegistry } from "../registry/agent-registry";
 import { type DiscoverableMCPSearchIndex, type DiscoverableMCPTool } from "../runtime-mcp/discoverable-tool-metadata";
 import { type SecretObfuscator } from "../secrets/obfuscator";
 import { type DiscoverableTool, type DiscoverableToolSearchIndex } from "../tool-discovery/tool-index";
+import type { ToolSession } from "../tools";
 import type { CheckpointState } from "../tools/checkpoint";
 import { type TodoItem, type TodoPhase } from "../tools/todo-write";
 import type { ClientBridge } from "./client-bridge";
@@ -166,6 +168,8 @@ export interface AgentSessionConfig {
     taskDepth?: number;
     /** Tool registry for LSP and settings */
     toolRegistry?: Map<string, AgentTool>;
+    /** Tool-session factory context used to lazily attach workflow-gate-only tools. */
+    workflowGateToolSession?: ToolSession;
     /** Current session pre-LLM message transform pipeline */
     transformContext?: (messages: AgentMessage[], signal?: AbortSignal) => AgentMessage[] | Promise<AgentMessage[]>;
     /** Provider payload hook used by the active session request path */
@@ -459,6 +463,10 @@ export declare class AgentSession {
      * Replace RPC host-owned tools and refresh the active tool set before the next model call.
      */
     refreshRpcHostTools(rpcTools: AgentTool[]): Promise<void>;
+    /**
+     * Refresh plugin sub-skill tools after workflow/sub-skill activation or phase changes.
+     */
+    refreshGjcSubskillTools(): Promise<void>;
     /** Whether auto-compaction is currently running */
     get isCompacting(): boolean;
     /**
@@ -496,6 +504,8 @@ export declare class AgentSession {
     setPlanModeState(state: PlanModeState | undefined): void;
     getGoalModeState(): GoalModeState | undefined;
     setGoalModeState(state: GoalModeState | undefined): void;
+    getWorkflowGateEmitter(): WorkflowGateEmitter | undefined;
+    setWorkflowGateEmitter(emitter: WorkflowGateEmitter | undefined): void;
     get goalRuntime(): GoalRuntime;
     markPlanReferenceSent(): void;
     setPlanReferencePath(path: string): void;

package/dist/types/session/blob-store.d.ts

@@ -26,9 +26,20 @@ export declare class BlobStore {
     putSync(data: Buffer): BlobPutResult;
     /** Read blob by hash, returns Buffer or null if not found. */
     get(hash: string): Promise<Buffer | null>;
+    /** Synchronously read blob by hash, returns Buffer or null if not found. */
+    getSync(hash: string): Buffer | null;
     /** Check if a blob exists. */
     has(hash: string): Promise<boolean>;
 }
+export declare class MemoryBlobStore extends BlobStore {
+    #private;
+    constructor();
+    put(data: Buffer): Promise<BlobPutResult>;
+    putSync(data: Buffer): BlobPutResult;
+    get(hash: string): Promise<Buffer | null>;
+    getSync(hash: string): Buffer | null;
+    has(hash: string): Promise<boolean>;
+}
 /** Check if a data string is a blob reference. */
 export declare function isBlobRef(data: string): boolean;
 /** Extract the SHA-256 hash from a blob reference string. */
@@ -61,3 +72,9 @@ export declare function resolveImageDataUrl(blobStore: BlobStore, data: string):
  * If the blob is missing, logs a warning and returns a placeholder.
  */
 export declare function resolveImageData(blobStore: BlobStore, data: string): Promise<string>;
+/** Synchronously resolve an externalized provider image data URL back to its original string. */
+export declare function resolveImageDataUrlSync(blobStore: BlobStore, data: string): string;
+/** Synchronously resolve a blob reference back to base64 data. */
+export declare function resolveImageDataSync(blobStore: BlobStore, data: string): string;
+/** Synchronously resolve a blob reference back to utf8 text. */
+export declare function resolveTextBlobSync(blobStore: BlobStore, data: string): string;

package/dist/types/session/messages.d.ts

@@ -8,6 +8,7 @@ import type { AgentMessage } from "@gajae-code/agent-core";
 import { type BranchSummaryMessage, type CompactionSummaryMessage } from "@gajae-code/agent-core/compaction/messages";
 import type { AssistantMessage, ImageContent, Message, MessageAttribution, TextContent } from "@gajae-code/ai";
 export { type BranchSummaryMessage, type CompactionSummaryMessage, createBranchSummaryMessage, createCompactionSummaryMessage, } from "@gajae-code/agent-core/compaction/messages";
+import type { LoadedSubskillActivation } from "../extensibility/gjc-plugins";
 import type { OutputMeta } from "../tools/output-meta";
 export declare const SKILL_PROMPT_MESSAGE_TYPE = "skill-prompt";
 export interface SkillPromptDetails {
@@ -15,6 +16,8 @@ export interface SkillPromptDetails {
     path: string;
     args?: string;
     lineCount: number;
+    subskillActivation?: LoadedSubskillActivation;
+    subskillActivationSet?: LoadedSubskillActivation[];
     /** Internal: tag used by AgentSession to remove the pending-display chip
      *  from `#steeringMessages` / `#followUpMessages` when the agent consumes
      *  this message. Not surfaced to renderers; the `__` prefix signals

package/dist/types/session/session-storage.d.ts

@@ -30,7 +30,9 @@ export interface SessionStorage {
     readTextPrefix(path: string, maxBytes: number): Promise<string>;
     writeText(path: string, content: string): Promise<void>;
     rename(path: string, nextPath: string): Promise<void>;
+    renameSync(path: string, nextPath: string): void;
     unlink(path: string): Promise<void>;
+    unlinkSync(path: string): void;
     deleteSessionWithArtifacts(sessionPath: string): Promise<void>;
     openWriter(path: string, options?: {
         flags?: "a" | "w";
@@ -49,7 +51,9 @@ export declare class FileSessionStorage implements SessionStorage {
     readTextPrefix(path: string, maxBytes: number): Promise<string>;
     writeText(path: string, content: string): Promise<void>;
     rename(path: string, nextPath: string): Promise<void>;
+    renameSync(path: string, nextPath: string): void;
     unlink(path: string): Promise<void>;
+    unlinkSync(path: string): void;
     openWriter(path: string, options?: {
         flags?: "a" | "w";
         onError?: (err: Error) => void;
@@ -73,7 +77,9 @@ export declare class MemorySessionStorage implements SessionStorage {
     readTextPrefix(path: string, maxBytes: number): Promise<string>;
     writeText(path: string, content: string): Promise<void>;
     rename(path: string, nextPath: string): Promise<void>;
+    renameSync(path: string, nextPath: string): void;
     unlink(path: string): Promise<void>;
+    unlinkSync(path: string): void;
     deleteSessionWithArtifacts(_sessionPath: string): Promise<void>;
     openWriter(path: string, options?: {
         flags?: "a" | "w";

package/dist/types/skill-state/active-state.d.ts

@@ -18,6 +18,16 @@ export interface WorkflowHudSummary {
     updated_at?: string;
 }
 export type { WorkflowStateReceipt } from "./workflow-state-contract";
+export interface ActiveSubskillEntry {
+    plugin: string;
+    subskillName: string;
+    parent: string;
+    bindsTo: string;
+    phase: string;
+    activationArg: string;
+    filePath: string;
+    toolPaths: string[];
+}
 export interface SkillActiveEntry {
     skill: string;
     phase?: string;
@@ -33,6 +43,7 @@ export interface SkillActiveEntry {
     handoff_from?: string;
     handoff_to?: string;
     handoff_at?: string;
+    active_subskills?: ActiveSubskillEntry[];
 }
 export interface SkillActiveState {
     version?: number;
@@ -49,6 +60,7 @@ export interface SkillActiveState {
     initialized_mode?: CanonicalGjcWorkflowSkill;
     initialized_state_path?: string;
     active_skills?: SkillActiveEntry[];
+    active_subskills?: ActiveSubskillEntry[];
     [key: string]: unknown;
 }
 export interface SkillActiveStatePaths {
@@ -70,6 +82,7 @@ export interface SyncSkillActiveStateOptions {
     handoff_from?: string;
     handoff_to?: string;
     handoff_at?: string;
+    active_subskills?: ActiveSubskillEntry[];
 }
 export declare function normalizeWorkflowHudSummary(raw: unknown): WorkflowHudSummary | undefined;
 export declare function isCanonicalGjcWorkflowSkill(skill: string): skill is CanonicalGjcWorkflowSkill;

package/dist/types/task/executor.d.ts

@@ -37,6 +37,7 @@ export interface ExecutorOptions {
      * if the resolved subagent model has no working credentials. See #985.
      */
     parentActiveModelPattern?: string;
+    parentSessionId?: string;
     thinkingLevel?: ThinkingLevel;
     outputSchema?: unknown;
     /** Parent task recursion depth (0 = top-level, 1 = first child, etc.) */

package/dist/types/thinking.d.ts

@@ -1,5 +1,6 @@
-import { type ResolvedThinkingLevel, ThinkingLevel } from "@gajae-code/agent-core";
-import { type Effort, type Model } from "@gajae-code/ai";
+import { type ResolvedThinkingLevel, ThinkingLevel } from "@gajae-code/agent-core/thinking";
+import { type Effort } from "@gajae-code/ai/model-thinking";
+import type { Model } from "@gajae-code/ai/types";
 /**
  * Metadata used to render thinking selector values in the coding-agent UI.
  */

package/dist/types/tools/hindsight-recall.d.ts

@@ -14,8 +14,6 @@ export declare class HindsightRecallTool implements AgentTool<typeof hindsightRe
         query: z.ZodString;
     }, z.core.$strip>;
     readonly strict = true;
-    readonly loadMode = "discoverable";
-    readonly summary = "Search hindsight memory for relevant prior context";
     constructor(session: ToolSession);
     static createIf(session: ToolSession): HindsightRecallTool | null;
     execute(_id: string, params: HindsightRecallParams, signal?: AbortSignal): Promise<AgentToolResult>;

package/dist/types/tools/hindsight-reflect.d.ts

@@ -16,8 +16,6 @@ export declare class HindsightReflectTool implements AgentTool<typeof hindsightR
         context: z.ZodOptional<z.ZodString>;
     }, z.core.$strip>;
     readonly strict = true;
-    readonly loadMode = "discoverable";
-    readonly summary = "Reflect on recent work and write hindsight memory";
     constructor(session: ToolSession);
     static createIf(session: ToolSession): HindsightReflectTool | null;
     execute(_id: string, params: HindsightReflectParams, signal?: AbortSignal): Promise<AgentToolResult>;

package/dist/types/tools/hindsight-retain.d.ts

@@ -20,8 +20,6 @@ export declare class HindsightRetainTool implements AgentTool<typeof hindsightRe
         }, z.core.$strip>>;
     }, z.core.$strip>;
     readonly strict = true;
-    readonly loadMode = "discoverable";
-    readonly summary = "Store important facts in hindsight memory";
     constructor(session: ToolSession);
     static createIf(session: ToolSession): HindsightRetainTool | null;
     execute(_id: string, params: HindsightRetainParams): Promise<AgentToolResult>;

package/dist/types/tools/index.d.ts

@@ -5,6 +5,7 @@ import type { Settings } from "../config/settings";
 import type { Skill } from "../extensibility/skills";
 import type { GoalModeState, GoalRuntime } from "../goals";
 import type { HindsightSessionState } from "../hindsight/state";
+import type { WorkflowGateEmitter } from "../modes/shared/agent-wire/unattended-session";
 import type { PlanModeState } from "../plan-mode/state";
 import type { AgentRegistry } from "../registry/agent-registry";
 import type { ForkContextSeed, ForkContextSeedOptions } from "../session/agent-session";
@@ -37,9 +38,6 @@ export * from "./debug";
 export * from "./eval";
 export * from "./find";
 export * from "./gh";
-export * from "./hindsight-recall";
-export * from "./hindsight-reflect";
-export * from "./hindsight-retain";
 export * from "./image-gen";
 export * from "./inspect-image";
 export * from "./irc";
@@ -153,6 +151,8 @@ export interface ToolSession {
     getPlanModeState?: () => PlanModeState | undefined;
     /** Goal mode state (if active or paused) */
     getGoalModeState?: () => GoalModeState | undefined;
+    /** Unattended workflow-gate emitter (present only when unattended mode is negotiated). */
+    getWorkflowGateEmitter?: () => WorkflowGateEmitter | undefined;
     /** Goal runtime for the active agent session. */
     getGoalRuntime?: () => GoalRuntime | undefined;
     /** Bridge to the connected client (e.g. ACP editor host). Tools should route fs/terminal/permission requests through this when available. */
@@ -245,7 +245,10 @@ export declare const DEFAULT_ESSENTIAL_TOOL_NAMES: readonly string[];
 export declare function computeEssentialBuiltinNames(settings: Settings): string[];
 /**
  * Public callable factory map. External callers may invoke `BUILTIN_TOOLS.read(session)` or
- * `BUILTIN_TOOLS[name](session)` to construct a tool directly.
+ * `BUILTIN_TOOLS[name](session)` to construct a public coding-harness tool directly.
+ *
+ * Hindsight memory helpers are intentionally excluded: memory is a private backend
+ * integration, not a public gajae-code tool surface.
  */
 export declare const BUILTIN_TOOLS: Record<string, ToolFactory>;
 export declare const HIDDEN_TOOLS: Record<string, ToolFactory>;

package/package.json

@@ -1,7 +1,7 @@
 {
 	"type": "module",
 	"name": "@gajae-code/coding-agent",
-	"version": "0.3.1",
+	"version": "0.4.0",
 	"description": "Gajae Code CLI with read, bash, edit, write tools and session management",
 	"homepage": "https://gaebal-gajae.dev",
 	"author": "Yeachan-Heo",
@@ -36,6 +36,8 @@
 		"check:types": "tsgo -p tsconfig.json --noEmit",
 		"lint": "biome lint .",
 		"test": "bun test",
+		"generate-schemas": "bun ../../scripts/generate-json-schemas.ts",
+		"check:schemas": "bun ../../scripts/generate-json-schemas.ts --check",
 		"fix": "biome check --write --unsafe . && bun run format-prompts && bun run generate-docs-index",
 		"fmt": "biome format --write . && bun run format-prompts",
 		"format-prompts": "bun scripts/format-prompts.ts",
@@ -48,12 +50,12 @@
 		"@agentclientprotocol/sdk": "0.21.0",
 		"@babel/parser": "^7.29.3",
 		"@mozilla/readability": "^0.6.0",
-		"@gajae-code/stats": "0.3.1",
-		"@gajae-code/agent-core": "0.3.1",
-		"@gajae-code/ai": "0.3.1",
-		"@gajae-code/natives": "0.3.1",
-		"@gajae-code/tui": "0.3.1",
-		"@gajae-code/utils": "0.3.1",
+		"@gajae-code/stats": "0.4.0",
+		"@gajae-code/agent-core": "0.4.0",
+		"@gajae-code/ai": "0.4.0",
+		"@gajae-code/natives": "0.4.0",
+		"@gajae-code/tui": "0.4.0",
+		"@gajae-code/utils": "0.4.0",
 		"@puppeteer/browsers": "^2.13.0",
 		"@types/turndown": "5.0.6",
 		"@xterm/headless": "^6.0.0",

package/src/cli/args.ts

@@ -17,6 +17,8 @@ export interface Args {
 	smol?: string;
 	slow?: string;
 	plan?: string;
+	mpreset?: string;
+	default?: boolean;
 	apiKey?: string;
 	systemPrompt?: string;
 	appendSystemPrompt?: string;
@@ -127,6 +129,10 @@ export function parseArgs(args: string[]): Args {
 			result.slow = args[++i];
 		} else if (arg === "--plan" && i + 1 < args.length) {
 			result.plan = args[++i];
+		} else if (arg === "--mpreset" && i + 1 < args.length) {
+			result.mpreset = args[++i];
+		} else if (arg === "--default") {
+			result.default = true;
 		} else if (arg === "--api-key" && i + 1 < args.length) {
 			result.apiKey = args[++i];
 		} else if (arg === "--system-prompt" && i + 1 < args.length) {
@@ -199,6 +205,10 @@ export function parseArgs(args: string[]): Args {
 		}
 	}
 
+	if (result.default && !result.mpreset) {
+		throw new Error("--default requires --mpreset <name>");
+	}
+
 	return result;
 }
 

package/src/cli.ts

@@ -84,6 +84,20 @@ function isSubcommand(first: string | undefined): boolean {
 async function runSmokeTest(): Promise<void> {
 	const { smokeTestSyncWorker } = await import("@gajae-code/stats");
 	await smokeTestSyncWorker();
+	// Prove the embedded native addon extracts and the new perf exports resolve in
+	// the COMPILED single binary (dev runs only load the on-disk .node). Loading the
+	// natives module triggers loadNative()/embedded extraction; calling each new
+	// export confirms the symbols are present in the shipped binary.
+	const { h06FormatHashLines, h02ScoreSequenceFuzzy, h01FindBestFuzzyMatch } = await import(
+		"../../natives/native/index.js"
+	);
+	const hashed = h06FormatHashLines("a\nb", 1);
+	if (hashed.split("\n").length !== 2) {
+		throw new Error(`smoke-test: h06FormatHashLines returned unexpected output: ${JSON.stringify(hashed)}`);
+	}
+	if (typeof h02ScoreSequenceFuzzy !== "function" || typeof h01FindBestFuzzyMatch !== "function") {
+		throw new Error("smoke-test: native fuzzy exports missing from embedded addon");
+	}
 	process.stdout.write("smoke-test: ok\n");
 }