@makaio/contracts 1.0.0-dev-1779051654000

package/dist/harness/codex-capability-map.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Canonical capability map for Codex native harness tools.
+ *
+ * This is shared by contracts defaults and the codex-app-server adapter to
+ * keep capability taxonomy in one place and avoid drift.
+ */
+export declare const codexCapabilityMap: {
+    readonly bash: readonly ["shell.execute", "file.read", "file.write", "file.delete", "network.request", "process.manage"];
+    readonly patch: readonly ["file.write"];
+};
+//# sourceMappingURL=codex-capability-map.d.ts.map

package/dist/harness/codex-capability-map.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"codex-capability-map.d.ts","sourceRoot":"","sources":["../../src/harness/codex-capability-map.ts"],"names":[],"mappings":"AAEA;;;;;GAKG;AACH,eAAO,MAAM,kBAAkB;;;CAG+B,CAAC"}

package/dist/harness/defaults.d.ts

@@ -0,0 +1,12 @@
+import type { DefaultHarnessDefinition } from './schemas.js';
+/** Default harness for codex-app-server native tools. */
+export declare const CODEX_APP_SERVER_NATIVE_HARNESS: DefaultHarnessDefinition;
+/** Default harness for openai-node adapter using registry tools only. */
+export declare const OPENAI_NODE_REGISTRY_HARNESS: DefaultHarnessDefinition;
+/** Default harness for claude-code adapter using registry tools only. */
+export declare const CLAUDE_CODE_REGISTRY_HARNESS: DefaultHarnessDefinition;
+/** Default harness for gemini-sdk adapter using registry tools only. */
+export declare const GEMINI_SDK_REGISTRY_HARNESS: DefaultHarnessDefinition;
+/** Shipped default harnesses registered during service initialization. */
+export declare const DEFAULT_HARNESSES: DefaultHarnessDefinition[];
+//# sourceMappingURL=defaults.d.ts.map

package/dist/harness/defaults.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"defaults.d.ts","sourceRoot":"","sources":["../../src/harness/defaults.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,cAAc,CAAC;AA0C7D,yDAAyD;AACzD,eAAO,MAAM,+BAA+B,EAAE,wBAsB7C,CAAC;AAEF,yEAAyE;AACzE,eAAO,MAAM,4BAA4B,EAAE,wBAKzC,CAAC;AAEH,yEAAyE;AACzE,eAAO,MAAM,4BAA4B,EAAE,wBAMzC,CAAC;AAEH,wEAAwE;AACxE,eAAO,MAAM,2BAA2B,EAAE,wBAMxC,CAAC;AAEH,0EAA0E;AAC1E,eAAO,MAAM,iBAAiB,EAAE,wBAAwB,EAKvD,CAAC"}

package/dist/harness/expand-capabilities.d.ts

@@ -0,0 +1,93 @@
+/**
+ * Capability expansion helpers shared by policy and resolution layers.
+ *
+ * These helpers are contract-owned because external consumers need the same
+ * canonical capability-to-tool expansion behavior without importing the
+ * harness service implementation package.
+ * @packageDocumentation
+ */
+import type { MakaioBusLike } from '@makaio/framework/core';
+import type { ToolCapability } from '../tool-capability/index.js';
+/**
+ * Looks up the declared capabilities for a tool name.
+ * @param toolName - Adapter-native tool name (e.g., 'bash', 'Read')
+ * @param capabilityMap - Map of tool names to their declared capabilities
+ * @returns Declared capabilities, or empty array if the tool has no capability mapping
+ */
+export declare function getToolCapabilities(toolName: string, capabilityMap: Readonly<Record<string, readonly ToolCapability[]>>): readonly ToolCapability[];
+/** Input parameters for {@link expandCapabilities}. */
+export interface ExpandCapabilitiesParams {
+    /** Tool names currently registered/enabled by the active harness. */
+    registeredTools: readonly string[];
+    /**
+     * Capabilities to allow. When empty, no capability-based filtering is
+     * applied and `allowedTools` in the result will be empty.
+     *
+     * Callers are expected to merge the returned `allowedTools` with any
+     * explicit `allowedTools` from the profile (Stance B overrides) at
+     * resolution time; this function does not handle that merge.
+     */
+    allowedCapabilities: readonly ToolCapability[];
+    /** Capabilities to disallow. */
+    disallowedCapabilities: readonly ToolCapability[];
+    /** Map of tool names to their declared capabilities. */
+    capabilityMap: Readonly<Record<string, readonly ToolCapability[]>>;
+}
+/** Expanded concrete tool name lists produced by {@link expandCapabilities}. */
+export interface ExpandCapabilitiesResult {
+    /** Tool names whose capabilities are all within the allowed set. */
+    allowedTools: string[];
+    /** Tool names that have at least one disallowed capability. */
+    disallowedTools: string[];
+}
+/**
+ * Expands capability filters to concrete tool names using the ALL-match rule.
+ * Only tools present in `registeredTools` are evaluated.
+ *
+ * A tool is included in `allowedTools` only if all its capabilities fall within
+ * the allowed set. A tool is included in `disallowedTools` if any of its
+ * capabilities falls within the disallowed set.
+ *
+ * Explicit `allowedTools` overrides (Stance B) are intentionally not handled
+ * here; that merge belongs to the caller.
+ * @param params - Expansion parameters; see {@link ExpandCapabilitiesParams}.
+ * @returns Expanded tool name lists; see {@link ExpandCapabilitiesResult}.
+ */
+export declare function expandCapabilities(params: ExpandCapabilitiesParams): ExpandCapabilitiesResult;
+/**
+ * Config shape consumed by {@link expandProfileToolCapabilities}.
+ * Matches the common subset shared by ProfileDefinition, Persona, and ad-hoc
+ * SubagentConfig-level callers.
+ */
+export interface ProfileToolCapabilitiesConfig {
+    /** Capabilities to allow; drives expansion to concrete tool names. */
+    allowedCapabilities?: readonly ToolCapability[];
+    /** Capabilities to disallow; drives expansion to concrete tool names. */
+    disallowedCapabilities?: readonly ToolCapability[];
+    /** Harness ID used to load the capability map and registered tools. */
+    harnessId?: string;
+    /** Explicit allowed tool names to union with expanded results (Stance B). */
+    allowedTools?: readonly string[];
+    /** Explicit disallowed tool names to union with expanded results (Stance B). */
+    disallowedTools?: readonly string[];
+}
+/**
+ * Expands capability-based filters from a profile-like config into concrete
+ * tool names, loading the harness capability map via bus.
+ *
+ * This is a no-op when no capability fields are set, when `harnessId` is
+ * absent, or when the resolved harness has no `toolCapabilityMap`. In all
+ * these cases the explicit `allowedTools` / `disallowedTools` are returned
+ * unchanged.
+ *
+ * Results are unioned with the explicit tool lists (Stance B): explicit names
+ * are never removed by capability expansion.
+ * @param bus - Bus for harness RPC
+ * @param config - Object with capability and explicit tool list fields
+ * @returns Expanded `allowedTools` and `disallowedTools` (Stance B union applied)
+ */
+export declare function expandProfileToolCapabilities(bus: MakaioBusLike, config: ProfileToolCapabilitiesConfig): Promise<{
+    allowedTools?: string[];
+    disallowedTools?: string[];
+}>;
+//# sourceMappingURL=expand-capabilities.d.ts.map

package/dist/harness/expand-capabilities.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"expand-capabilities.d.ts","sourceRoot":"","sources":["../../src/harness/expand-capabilities.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAClD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,6BAA6B,CAAC;AAGlE;;;;;GAKG;AACH,wBAAgB,mBAAmB,CACjC,QAAQ,EAAE,MAAM,EAChB,aAAa,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,SAAS,cAAc,EAAE,CAAC,CAAC,GACjE,SAAS,cAAc,EAAE,CAE3B;AAED,uDAAuD;AACvD,MAAM,WAAW,wBAAwB;IACvC,qEAAqE;IACrE,eAAe,EAAE,SAAS,MAAM,EAAE,CAAC;IACnC;;;;;;;OAOG;IACH,mBAAmB,EAAE,SAAS,cAAc,EAAE,CAAC;IAC/C,gCAAgC;IAChC,sBAAsB,EAAE,SAAS,cAAc,EAAE,CAAC;IAClD,wDAAwD;IACxD,aAAa,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,SAAS,cAAc,EAAE,CAAC,CAAC,CAAC;CACpE;AAED,gFAAgF;AAChF,MAAM,WAAW,wBAAwB;IACvC,oEAAoE;IACpE,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB,+DAA+D;IAC/D,eAAe,EAAE,MAAM,EAAE,CAAC;CAC3B;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,wBAAwB,GAAG,wBAAwB,CAuB7F;AAED;;;;GAIG;AACH,MAAM,WAAW,6BAA6B;IAC5C,sEAAsE;IACtE,mBAAmB,CAAC,EAAE,SAAS,cAAc,EAAE,CAAC;IAChD,yEAAyE;IACzE,sBAAsB,CAAC,EAAE,SAAS,cAAc,EAAE,CAAC;IACnD,uEAAuE;IACvE,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,6EAA6E;IAC7E,YAAY,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IACjC,gFAAgF;IAChF,eAAe,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;CACrC;AAuCD;;;;;;;;;;;;;;GAcG;AACH,wBAAsB,6BAA6B,CACjD,GAAG,EAAE,aAAa,EAClB,MAAM,EAAE,6BAA6B,GACpC,OAAO,CAAC;IAAE,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;IAAC,eAAe,CAAC,EAAE,MAAM,EAAE,CAAA;CAAE,CAAC,CA0BlE"}

package/dist/harness/index.d.ts

@@ -0,0 +1,8 @@
+export { ApprovalPolicySchema, HarnessDefinitionBaseSchema, HarnessDefinitionCreateSchema, HarnessDefinitionSchema, ToolApprovalOverridesSchema, } from './schemas.js';
+export type { ApprovalPolicy, DefaultHarnessDefinition, HarnessDefinition, HarnessDefinitionCreate, ToolApprovalOverrides, } from './schemas.js';
+export { HarnessNamespace, HarnessSchemas, HarnessSubjects } from './namespace.js';
+export { expandCapabilities, expandProfileToolCapabilities, getToolCapabilities } from './expand-capabilities.js';
+export type { ExpandCapabilitiesParams, ExpandCapabilitiesResult, ProfileToolCapabilitiesConfig, } from './expand-capabilities.js';
+export { codexCapabilityMap } from './codex-capability-map.js';
+export { CLAUDE_CODE_REGISTRY_HARNESS, CODEX_APP_SERVER_NATIVE_HARNESS, DEFAULT_HARNESSES, GEMINI_SDK_REGISTRY_HARNESS, OPENAI_NODE_REGISTRY_HARNESS, } from './defaults.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/harness/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/harness/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,oBAAoB,EACpB,2BAA2B,EAC3B,6BAA6B,EAC7B,uBAAuB,EACvB,2BAA2B,GAC5B,MAAM,cAAc,CAAC;AACtB,YAAY,EACV,cAAc,EACd,wBAAwB,EACxB,iBAAiB,EACjB,uBAAuB,EACvB,qBAAqB,GACtB,MAAM,cAAc,CAAC;AACtB,OAAO,EAAE,gBAAgB,EAAE,cAAc,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;AACnF,OAAO,EAAE,kBAAkB,EAAE,6BAA6B,EAAE,mBAAmB,EAAE,MAAM,0BAA0B,CAAC;AAClH,YAAY,EACV,wBAAwB,EACxB,wBAAwB,EACxB,6BAA6B,GAC9B,MAAM,0BAA0B,CAAC;AAClC,OAAO,EAAE,kBAAkB,EAAE,MAAM,2BAA2B,CAAC;AAC/D,OAAO,EACL,4BAA4B,EAC5B,+BAA+B,EAC/B,iBAAiB,EACjB,2BAA2B,EAC3B,4BAA4B,GAC7B,MAAM,eAAe,CAAC"}

package/dist/harness/index.mjs

@@ -0,0 +1 @@
+import{a as e,i as t,n,r,t as i}from"../schemas-BJb5W0VZ.mjs";import{a,c as o,d as s,f as c,i as l,l as u,n as d,o as f,r as p,s as m,t as h,u as g}from"../harness-BMzrOThN.mjs";export{i as ApprovalPolicySchema,h as CLAUDE_CODE_REGISTRY_HARNESS,d as CODEX_APP_SERVER_NATIVE_HARNESS,p as DEFAULT_HARNESSES,l as GEMINI_SDK_REGISTRY_HARNESS,n as HarnessDefinitionBaseSchema,r as HarnessDefinitionCreateSchema,t as HarnessDefinitionSchema,g as HarnessNamespace,s as HarnessSchemas,c as HarnessSubjects,a as OPENAI_NODE_REGISTRY_HARNESS,e as ToolApprovalOverridesSchema,f as codexCapabilityMap,m as expandCapabilities,o as expandProfileToolCapabilities,u as getToolCapabilities};