@agntn/harnesses 0.1.1 → 0.2.1

package/dist/_chunks/{agents-sync.d.mts → prompt-sync.d.mts}

@@ -1,20 +1,25 @@
-declare const version: string;
-type HarnessId = "antigravity" | "codex" | "gemini" | "grok" | "claude" | "opencode" | "cursor" | "freebuff" | "github-copilot" | "mastracode" | "omp" | "pi" | "prime-agent";
-type EvidenceLevel = "official" | "community" | "inferred";
-type Platform = "linux" | "darwin" | "win32";
-interface PathCandidate {
+export declare const version: string;
+export type HarnessId = "antigravity" | "codex" | "gemini" | "grok" | "claude" | "opencode" | "cursor" | "freebuff" | "github-copilot" | "mastracode" | "omp" | "pi" | "prime-agent";
+export type EvidenceLevel = "official" | "community" | "inferred";
+export type Platform = "linux" | "darwin" | "win32";
+export interface PathCandidate {
   path: string;
   scope: "user" | "project" | "system" | "data";
   level: EvidenceLevel;
   platforms?: Platform[];
   note?: string;
 }
-interface StorageDescriptor {
+/** One stable user-scope destination used by prompt template synchronization. */
+export interface PromptTemplateSyncTarget extends PathCandidate {
+  scope: "user";
+  format: "markdown" | "gemini-toml";
+}
+export interface StorageDescriptor {
   format: string;
   level: EvidenceLevel;
   note?: string;
 }
-interface HarnessCapabilities {
+export interface HarnessCapabilities {
   mcp: boolean;
   vision: boolean;
   /** Audio reaches the model without conversion or MCP. */
@@ -25,7 +30,7 @@ interface HarnessCapabilities {
   streaming: boolean;
 }
 /** How to run one prompt through the harness non-interactively. */
-interface HarnessInvocation {
+export interface HarnessInvocation {
   /** Binary to spawn; defaults to the harness's first `binaries` entry. */
   binary?: string;
   /** Full agent argument template; every "{prompt}" is replaced with the prompt text. */
@@ -48,7 +53,7 @@ interface HarnessInvocation {
   note?: string;
 }
 /** Invocation modes a harness supports without fallback or prompt-only restrictions. */
-interface HarnessInvocationModes {
+export interface HarnessInvocationModes {
   advisor: boolean;
   advisorStructured: boolean;
   readOnly: boolean;
@@ -57,7 +62,7 @@ interface HarnessInvocationModes {
   agentStructured: boolean;
 }
 /** How to ask one harness CLI for the models currently available to it. */
-interface HarnessModelListing {
+export interface HarnessModelListing {
   /** Arguments used when no search filter is supplied. */
   args: string[];
   /** Optional argument template for a search filter; every "{search}" is replaced. */
@@ -66,7 +71,7 @@ interface HarnessModelListing {
   note?: string;
 }
 /** One model normalized from a harness's native model-listing output. */
-interface AvailableModel {
+export interface AvailableModel {
   provider: string;
   id: string;
   contextWindow: number;
@@ -75,7 +80,7 @@ interface AvailableModel {
   images: boolean;
 }
 /** Options for querying the models available to one harness. */
-interface ListModelsOptions {
+export interface ListModelsOptions {
   search?: string;
   cwd?: string;
   env?: Record<string, string>;
@@ -84,7 +89,7 @@ interface ListModelsOptions {
   /** Cancel with the same process cleanup as a timeout. */
   signal?: AbortSignal;
 }
-interface InvokeOptions {
+export interface InvokeOptions {
   cwd?: string;
   env?: Record<string, string>;
   /** Harness-native model id or selector. */
@@ -100,7 +105,7 @@ interface InvokeOptions {
   /** Use the harness's structured (JSON) output mode instead of plain text. */
   structured?: boolean;
 }
-interface InvokeResult {
+export interface InvokeResult {
   command: string;
   args: string[];
   stdout: string;
@@ -112,12 +117,12 @@ interface InvokeResult {
   aborted: boolean;
 }
 /** Result of one native model-listing command. */
-interface ListModelsResult extends InvokeResult {
+export interface ListModelsResult extends InvokeResult {
   /** Empty on a successful no-match response or when the command itself failed. */
   models: AvailableModel[];
 }
 /** Normalized MCP server entry, shared across every harness dialect. */
-interface McpServerConfig {
+export interface McpServerConfig {
   name: string;
   transport: "stdio" | "http" | "sse";
   command?: string;
@@ -134,33 +139,36 @@ interface McpServerConfig {
   enabled?: boolean;
 }
 /** How one harness config file stores its MCP servers. */
-interface McpConfigFile extends PathCandidate {
+export interface McpConfigFile extends PathCandidate {
   format: "json" | "toml";
   /** Object path to the server map inside the file, e.g. ["mcpServers"]. */
   key: string[];
   /**
    * Shape of individual entries; "standard" is the {command, args, env, url}
-   * family and "prime" is that family with env values as {"env": "NAME"} references.
+   * family, "prime" is that family with env values as {"env": "NAME"} references
+   * and "mastracode" is that family read by its keys alone, type ignored.
    */
-  dialect: "standard" | "antigravity" | "opencode" | "prime" | "vscode";
+  dialect: "standard" | "antigravity" | "mastracode" | "opencode" | "prime" | "vscode";
 }
-interface HarnessDetection {
+export interface HarnessDetection {
   /** Environment variables that indicate running inside this agent. */
   envVars: string[];
   /** Project-level files or directories whose presence indicates this agent. */
   projectMarkers: string[];
 }
-interface ResolveOptions {
+export interface ResolveOptions {
   homeDir?: string;
   projectRoot?: string;
   platform?: Platform;
 }
-interface ResolvedPaths {
+export interface ResolvedPaths {
   config: PathCandidate[];
   sessions: PathCandidate[];
   instructions: PathCandidate[];
   skills: PathCandidate[];
   commands: PathCandidate[];
+  promptTemplates: PathCandidate[];
+  promptTemplateSyncTarget: PromptTemplateSyncTarget | null;
   hooks: PathCandidate[];
 }
 type InvocationOptions = Readonly<{
@@ -169,7 +177,7 @@ type InvocationOptions = Readonly<{
   tools?: boolean;
   readOnly?: boolean;
 }>;
-declare abstract class Harness {
+export declare abstract class Harness {
   abstract readonly id: HarnessId;
   abstract readonly name: string;
   abstract readonly binaries: string[];
@@ -179,6 +187,10 @@ declare abstract class Harness {
   abstract readonly instructions: PathCandidate[];
   abstract readonly skills: PathCandidate[];
   abstract readonly commands: PathCandidate[];
+  /** Reusable prompt files; empty when no CLI template location is verified. */
+  readonly promptTemplates: PathCandidate[];
+  /** Stable user-scope destination used by prompt template synchronization. */
+  readonly promptTemplateSyncTarget: PromptTemplateSyncTarget | null;
   abstract readonly hooks: PathCandidate[];
   abstract readonly capabilities: HarnessCapabilities;
   abstract readonly detection: HarnessDetection;
@@ -279,9 +291,9 @@ declare abstract class Harness {
   resolveCandidates<T extends PathCandidate>(entries: readonly T[], options?: ResolveOptions): T[];
   resolve(options?: ResolveOptions): ResolvedPaths;
 }
-type HarnessConstructor = new () => Harness;
+export type HarnessConstructor = new () => Harness;
 /** One resolved config file together with the servers it declares. */
-interface McpConfigListing {
+export interface McpConfigListing {
   path: string;
   scope: McpConfigFile["scope"];
   format: McpConfigFile["format"];
@@ -293,7 +305,7 @@ interface McpConfigListing {
   error?: string;
 }
 /** Thrown when a server's env cannot be written the way the target dialect requires. */
-declare class McpEnvError extends Error {
+export declare class McpEnvError extends Error {
   readonly name = "McpEnvError";
 }
 /**
@@ -304,7 +316,7 @@ declare class McpEnvError extends Error {
  * @param options - Platform and path-resolution overrides.
  * @returns {McpConfigListing[]} One listing per declared config file.
  */
-declare function listMcpServers(harness: Harness, options?: ResolveOptions): McpConfigListing[];
+export declare function listMcpServers(harness: Harness, options?: ResolveOptions): McpConfigListing[];
 /**
  * Adds (or replaces) one MCP server in a harness's config. The rest of the
  * file is preserved: JSON through a parse/serialize round trip (formatting
@@ -316,7 +328,7 @@ declare function listMcpServers(harness: Harness, options?: ResolveOptions): Mcp
  * @param options - Platform and path-resolution overrides.
  * @returns {{ path: string, replaced: boolean }} The written path and replacement status.
  */
-declare function addMcpServer(harness: Harness, server: McpServerConfig, scope?: "user" | "project", options?: ResolveOptions): {
+export declare function addMcpServer(harness: Harness, server: McpServerConfig, scope?: "user" | "project", options?: ResolveOptions): {
   path: string;
   replaced: boolean;
 };
@@ -329,7 +341,7 @@ declare function addMcpServer(harness: Harness, server: McpServerConfig, scope?:
  * @param options - Platform and path-resolution overrides.
  * @returns {{ path: string, removed: boolean }} The targeted path and removal status.
  */
-declare function removeMcpServer(harness: Harness, name: string, scope?: "user" | "project", options?: ResolveOptions): {
+export declare function removeMcpServer(harness: Harness, name: string, scope?: "user" | "project", options?: ResolveOptions): {
   path: string;
   removed: boolean;
 };
@@ -340,16 +352,16 @@ declare function removeMcpServer(harness: Harness, name: string, scope?: "user"
  * @param text - JSONC source text.
  * @returns {unknown} The parsed JSON value.
  */
-declare function parseJsonc(text: string): unknown;
+export declare function parseJsonc(text: string): unknown;
 /**
  * Resolves the master sync file path: $XDG_CONFIG_HOME or ~/.config.
  *
  * @param options - Path-resolution overrides.
  * @returns {string} The resolved master MCP config path.
  */
-declare function masterMcpPath(options?: ResolveOptions): string;
+export declare function masterMcpPath(options?: ResolveOptions): string;
 /** One harness's outcome of a sync run. */
-interface SyncTargetResult {
+export interface SyncTargetResult {
   id: string;
   path?: string;
   /** Reason this harness could not be targeted; `results` is empty then. */
@@ -364,7 +376,7 @@ interface SyncTargetResult {
   }>;
 }
 /** Outcome of resetting the harness configs to the master list. */
-interface SyncReport {
+export interface SyncReport {
   source: string;
   servers: string[];
   targets: SyncTargetResult[];
@@ -375,7 +387,7 @@ interface SyncReport {
  * @param options - Path-resolution overrides.
  * @returns {{ path: string, servers: McpServerConfig[], excludes: string[] }} The master list.
  */
-declare function readMasterMcpServers(options?: ResolveOptions): {
+export declare function readMasterMcpServers(options?: ResolveOptions): {
   path: string;
   servers: McpServerConfig[];
   /** Harness ids the master list opts out of syncing. */
@@ -390,9 +402,9 @@ declare function readMasterMcpServers(options?: ResolveOptions): {
  * @param options - Platform and path-resolution overrides.
  * @returns {SyncReport} Per-harness synchronization outcomes.
  */
-declare function syncMcpServers(harnesses: readonly Harness[], options?: ResolveOptions): SyncReport;
+export declare function syncMcpServers(harnesses: readonly Harness[], options?: ResolveOptions): SyncReport;
 /** Configuration read from agents.jsonc. */
-interface AgentsConfig {
+export interface AgentsConfig {
   /** The master instructions file every harness links to. */
   source: string;
   /** Relative files to link beside every harness instructions target. */
@@ -402,9 +414,9 @@ interface AgentsConfig {
   /** Path the config was read from; absent when defaults were used. */
   configPath?: string;
 }
-type AgentsSyncAction = "linked" | "relinked" | "adopted" | "unchanged" | "skipped";
+export type AgentsSyncAction = "linked" | "relinked" | "adopted" | "unchanged" | "skipped";
 /** One companion file's outcome for a harness target. */
-interface AgentsCompanionTargetResult {
+export interface AgentsCompanionTargetResult {
   readonly source: string;
   readonly path: string;
   readonly action: Exclude<AgentsSyncAction, "skipped">;
@@ -412,7 +424,7 @@ interface AgentsCompanionTargetResult {
   readonly detail?: string;
 }
 /** One harness's outcome of an agents sync run. */
-interface AgentsTargetResult {
+export interface AgentsTargetResult {
   id: string;
   path?: string;
   action: AgentsSyncAction;
@@ -422,7 +434,7 @@ interface AgentsTargetResult {
   companions?: readonly AgentsCompanionTargetResult[];
 }
 /** Outcome of one agents sync/doctor run. */
-interface AgentsSyncReport {
+export interface AgentsSyncReport {
   source: string;
   check: boolean;
   targets: AgentsTargetResult[];
@@ -433,7 +445,7 @@ interface AgentsSyncReport {
  * @param options - Path-resolution overrides.
  * @returns {AgentsConfig} The normalized sync configuration.
  */
-declare function readAgentsConfig(options?: ResolveOptions): AgentsConfig;
+export declare function readAgentsConfig(options?: ResolveOptions): AgentsConfig;
 /**
  * Links every harness's user-scope instructions file to the master. In check
  * mode nothing is written; the report shows what a real run would do.
@@ -443,6 +455,41 @@ declare function readAgentsConfig(options?: ResolveOptions): AgentsConfig;
  * @param options - Path-resolution overrides.
  * @returns {AgentsSyncReport} Per-harness synchronization outcomes.
  */
-declare function syncAgentsFiles(harnesses: readonly Harness[], check?: boolean, options?: ResolveOptions): AgentsSyncReport;
-export { AgentsCompanionTargetResult, AgentsConfig, AgentsSyncAction, AgentsSyncReport, AgentsTargetResult, AvailableModel, EvidenceLevel, Harness, HarnessCapabilities, HarnessConstructor, HarnessDetection, HarnessId, HarnessInvocation, HarnessInvocationModes, HarnessModelListing, InvokeOptions, InvokeResult, ListModelsOptions, ListModelsResult, McpConfigFile, McpConfigListing, McpEnvError, McpServerConfig, PathCandidate, Platform, ResolveOptions, ResolvedPaths, StorageDescriptor, SyncReport, SyncTargetResult, addMcpServer, listMcpServers, masterMcpPath, parseJsonc, readAgentsConfig, readMasterMcpServers, removeMcpServer, syncAgentsFiles, syncMcpServers, version };
-//# sourceMappingURL=agents-sync.d.mts.map
+export declare function syncAgentsFiles(harnesses: readonly Harness[], check?: boolean, options?: ResolveOptions): AgentsSyncReport;
+export type PromptSyncAction = "linked" | "generated" | "relinked" | "replaced" | "adopted" | "removed" | "unchanged" | "skipped";
+/** One prompt template's outcome at a harness destination. */
+export interface PromptTemplateTargetResult {
+  readonly name: string;
+  readonly source?: string;
+  readonly path: string;
+  readonly action: PromptSyncAction;
+  /** Backup path, skip reason, or a check-mode note. */
+  readonly detail?: string;
+}
+/** One harness's outcome of a prompt template sync run. */
+export interface PromptSyncTargetResult {
+  readonly id: string;
+  readonly path?: string;
+  readonly format?: PromptTemplateSyncTarget["format"];
+  readonly detail?: string;
+  readonly templates: readonly PromptTemplateTargetResult[];
+}
+/** Outcome of one prompt template sync run. */
+export interface PromptSyncReport {
+  readonly source: string;
+  readonly check: boolean;
+  readonly templates: readonly string[];
+  readonly targets: readonly PromptSyncTargetResult[];
+}
+/**
+ * Synchronizes canonical Markdown prompt templates into each harness's stable
+ * user-scope destination. Markdown harnesses receive symlinks; Gemini receives
+ * generated TOML commands. In check mode nothing is written.
+ *
+ * @param harnesses - Harnesses to inspect or update.
+ * @param check - Report intended changes without writing them.
+ * @param options - Path-resolution overrides.
+ * @returns {PromptSyncReport} Per-harness synchronization outcomes.
+ */
+export declare function syncPromptTemplates(harnesses: readonly Harness[], check?: boolean, options?: ResolveOptions): PromptSyncReport;
+//# sourceMappingURL=prompt-sync.d.mts.map

package/dist/_chunks/prompt-sync.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"prompt-sync.d.mts","names":[],"sources":["../../src/types.ts","../../src/harness.ts","../../src/mcp-servers.ts","../../src/agents-sync.ts","../../src/prompt-sync.ts"],"mappings":"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"}