@fabric-harness/sdk 0.1.0

package/dist/types.d.ts

@@ -0,0 +1,343 @@
+import type { AgentLoopRuntime } from './loop.js';
+import type { FabricSession } from './session.js';
+import type { ModelProvider } from './model.js';
+import type { ModelConfig, ProvidersConfig } from './providers.js';
+import type { CapabilityPolicy } from './policy.js';
+import type { SandboxEnv, SandboxFactory } from './sandbox.js';
+import type { Command, SecretRef, ToolCall, ToolDef } from './tools.js';
+export type JsonPrimitive = string | number | boolean | null;
+export type JsonValue = JsonPrimitive | JsonValue[] | {
+    [key: string]: JsonValue;
+};
+export type JsonObject = {
+    [key: string]: JsonValue;
+};
+export interface ActorIdentity {
+    id: string;
+    type?: 'user' | 'agent' | 'service' | 'system';
+    provider?: string;
+    tenantId?: string;
+    displayName?: string;
+}
+export interface FabricActor {
+    agentId?: string | ActorIdentity;
+    onBehalfOf?: string | ActorIdentity;
+    approver?: string | ActorIdentity;
+}
+/**
+ * Execution runtime selection.
+ *
+ * - `inline` (default): single-process execution. Uses the configured
+ *   `SessionStore` (in-memory by default) for history, artifacts, approvals.
+ * - `stateless`: explicit headless / ephemeral mode. No session store,
+ *   no artifact persistence, no approval waiting. Each invocation is
+ *   independent. Use for high-volume webhook agents and edge runtimes
+ *   where state would just be discarded anyway. In production
+ *   (`FABRIC_ENV=production` or `NODE_ENV=production`) this mode must
+ *   be selected explicitly — `inline` without an explicit store will
+ *   warn or fail depending on `FABRIC_ALLOW_EPHEMERAL_STATE`.
+ * - `temporal`: durable, restartable workflows via @fabric-harness/temporal.
+ */
+export type FabricRuntime = 'inline' | 'stateless' | 'temporal';
+export type AutonomyMode = 'background' | 'interactive';
+export type MissingInputStrategy = 'assume' | 'fail';
+export type ApprovalUnavailableStrategy = 'fail' | 'deny' | 'wait';
+export type CredentialMissingStrategy = 'fail';
+export interface AutonomyOptions {
+    /**
+     * background means no human operator is assumed. Agents should make safe
+     * progress, fail with actionable errors when blocked, and use approvals as
+     * control-plane gates rather than asking clarifying questions in-band.
+     */
+    mode?: AutonomyMode;
+    onMissingInput?: MissingInputStrategy;
+    onApprovalUnavailable?: ApprovalUnavailableStrategy;
+    onCredentialMissing?: CredentialMissingStrategy;
+}
+export type SandboxBackend = 'empty' | 'local' | 'docker' | 'azure-container-apps' | 'azure-container-instances' | 'aks' | 'databricks' | 'e2b' | 'daytona' | 'cloudflare' | 'modal' | 'kubernetes' | 'firecracker';
+export interface FabricContext<TPayload = JsonObject> {
+    init: (options?: AgentInit) => Promise<FabricAgent>;
+    payload: TPayload;
+    env?: Record<string, string | undefined>;
+    request?: unknown;
+}
+export interface AgentInit {
+    id?: string;
+    name?: string;
+    model?: ModelConfig;
+    modelProvider?: ModelProvider;
+    providers?: ProvidersConfig;
+    loopRuntime?: AgentLoopRuntime;
+    runtime?: FabricRuntime;
+    sandbox?: SandboxBackend | SandboxFactory | SandboxEnv;
+    role?: string | Role;
+    roles?: Role[];
+    skills?: Skill[];
+    tools?: ToolDef[];
+    commands?: Command[];
+    policy?: CapabilityPolicy;
+    store?: SessionStore;
+    metadata?: JsonObject;
+    actor?: FabricActor;
+    autonomy?: AutonomyOptions;
+    onEvent?: FabricEventCallback;
+    resolveSecret?: (ref: SecretRef) => string | undefined | Promise<string | undefined>;
+    onApproval?: ApprovalCallback;
+}
+export interface FabricAgent {
+    readonly id: string;
+    readonly model?: string;
+    readonly role?: string | Role;
+    session(id?: string, options?: SessionOptions): Promise<FabricSession>;
+}
+export interface SessionOptions {
+    id?: string;
+    role?: string | Role;
+    model?: ModelConfig;
+    modelProvider?: ModelProvider;
+    providers?: ProvidersConfig;
+    loopRuntime?: AgentLoopRuntime;
+    store?: SessionStore;
+    roles?: Role[];
+    skills?: Skill[];
+    sandbox?: SandboxBackend | SandboxFactory | SandboxEnv;
+    tools?: ToolDef[];
+    commands?: Command[];
+    policy?: CapabilityPolicy;
+    metadata?: JsonObject;
+    actor?: FabricActor;
+    autonomy?: AutonomyOptions;
+    onEvent?: FabricEventCallback;
+    resolveSecret?: (ref: SecretRef) => string | undefined | Promise<string | undefined>;
+    onApproval?: ApprovalCallback;
+    approvalTimeoutMs?: number;
+}
+export interface PromptOptions<TResult = unknown> {
+    role?: string | Role;
+    model?: ModelConfig;
+    modelProvider?: ModelProvider;
+    providers?: ProvidersConfig;
+    tools?: ToolDef[];
+    commands?: Command[];
+    policy?: CapabilityPolicy;
+    toolCalls?: ToolCall[];
+    loopRuntime?: AgentLoopRuntime;
+    maxIterations?: number;
+    modelTimeoutMs?: number;
+    modelRetries?: number;
+    modelRetryDelayMs?: number;
+    contextWindowTokens?: number;
+    compactAtTokens?: number;
+    reserveTokens?: number;
+    autoCompact?: boolean;
+    compactionKeepRecentEntries?: number;
+    recoverContextOverflow?: boolean;
+    approvalTimeoutMs?: number;
+    signal?: AbortSignal;
+    onEvent?: FabricEventCallback;
+    onApproval?: ApprovalCallback;
+    result?: ResultValidator<TResult>;
+    resultExtraction?: boolean | ResultExtractionOptions;
+    resultRetries?: number;
+    metadata?: JsonObject;
+    autonomy?: AutonomyOptions;
+}
+export interface SkillOptions<TResult = unknown> extends PromptOptions<TResult> {
+    args?: JsonObject;
+}
+export interface TaskOptions<TResult = unknown> extends PromptOptions<TResult> {
+    id?: string;
+    agent?: string;
+    /** Create a sandbox checkpoint before and after task execution for resumability/audit. */
+    checkpoint?: boolean | string;
+    metadata?: JsonObject;
+}
+export interface ShellOptions {
+    cwd?: string;
+    env?: Record<string, string>;
+    timeout?: number;
+    signal?: AbortSignal;
+    command?: Command;
+    policy?: CapabilityPolicy;
+    approvalTimeoutMs?: number;
+    onApproval?: ApprovalCallback;
+}
+export interface ShellResult {
+    command: string;
+    exitCode: number;
+    stdout: string;
+    stderr: string;
+    durationMs?: number;
+    signal?: string;
+}
+export interface Skill {
+    name: string;
+    description?: string;
+    path?: string;
+    model?: string;
+    content?: string;
+    metadata?: JsonObject;
+}
+export interface Role {
+    name: string;
+    description?: string;
+    path?: string;
+    model?: string;
+    content: string;
+    metadata?: JsonObject;
+}
+export interface ArtifactCreateOptions {
+    contentType?: string;
+    metadata?: JsonObject;
+}
+export interface ArtifactRef {
+    id: string;
+    sessionId: string;
+    name: string;
+    path: string;
+    contentType?: string;
+    size: number;
+    sha256: string;
+    createdAt: string;
+    uri?: string;
+    metadata?: JsonObject;
+}
+export interface SessionStore {
+    load(id: string): Promise<SessionData | undefined>;
+    save(data: SessionData): Promise<void>;
+    /** Optional store-wide listing for dashboard/ops commands. */
+    listSessions?(): Promise<SessionData[]>;
+    appendEvent?(sessionId: string, event: FabricEvent): Promise<void>;
+    appendEntry?(sessionId: string, entry: SessionEntry): Promise<void>;
+    waitForApproval?(sessionId: string, approvalId: string, timeoutMs?: number): Promise<ApprovalResponse | undefined>;
+    resolveApproval?(sessionId: string, approvalId: string, response: ApprovalResponse): Promise<void>;
+    voteApproval?(sessionId: string, approvalId: string, vote: ApprovalVote): Promise<ApprovalState>;
+    getApprovalState?(sessionId: string, approvalId: string): Promise<ApprovalState | undefined>;
+    listApprovalStates?(sessionId: string): Promise<ApprovalState[]>;
+    putArtifact?(sessionId: string, name: string, content: string | Uint8Array, options?: ArtifactCreateOptions): Promise<ArtifactRef>;
+    getArtifact?(sessionId: string, artifactIdOrName: string): Promise<{
+        ref: ArtifactRef;
+        content: Uint8Array;
+    } | undefined>;
+    listArtifacts?(sessionId: string): Promise<ArtifactRef[]>;
+}
+export type SessionEntryType = 'user_prompt' | 'assistant_message' | 'model_attempt' | 'tool_call' | 'tool_result' | 'shell_command' | 'shell_result' | 'task_start' | 'task_checkpoint' | 'task_end' | 'task_failed' | 'task_cancelled' | 'artifact_created' | 'metric' | 'skill_start' | 'skill_end' | 'checkpoint_created' | 'checkpoint_restored' | 'compaction' | 'approval_requested' | 'approval_voted' | 'approval_granted' | 'approval_denied' | 'approval_expired' | 'result' | 'result_retry' | 'activity_result' | 'error';
+export interface SessionEntry<TData = JsonObject> {
+    id: string;
+    type: SessionEntryType;
+    timestamp: string;
+    parentId?: string;
+    actor?: FabricActor;
+    data?: TData;
+}
+export interface SessionData {
+    id: string;
+    agentId?: string;
+    createdAt: string;
+    updatedAt: string;
+    metadata?: JsonObject;
+    events?: FabricEvent[];
+    entries?: SessionEntry[];
+    leafId?: string;
+}
+export interface CheckpointCreateOptions {
+    label: string;
+    metadata?: JsonObject;
+}
+export interface CheckpointRestoreOptions {
+    label: string;
+}
+export interface CheckpointResult {
+    label: string;
+    entryId: string;
+    snapshotId?: string;
+}
+export interface CompactionOptions {
+    keepRecentEntries?: number;
+    summary?: string;
+    generateSummary?: boolean;
+}
+export interface CompactionResult {
+    entryId: string;
+    summary: string;
+    compactedEntries: number;
+    firstKeptEntryId?: string;
+}
+export type FabricEventType = 'text_delta' | 'turn_start' | 'turn_end' | 'model_attempt' | 'agent_start' | 'session_start' | 'prompt_start' | 'prompt_end' | 'skill_start' | 'skill_end' | 'task_start' | 'task_checkpoint' | 'task_end' | 'task_failed' | 'task_cancelled' | 'artifact_created' | 'metric' | 'command_start' | 'command_end' | 'tool_start' | 'tool_end' | 'checkpoint_created' | 'checkpoint_restored' | 'compaction' | 'approval_requested' | 'approval_voted' | 'approval_granted' | 'approval_denied' | 'approval_expired' | 'error' | 'result_retry' | 'result';
+export interface FabricEvent<TData = JsonObject> {
+    id: string;
+    type: FabricEventType;
+    timestamp: string;
+    sessionId?: string;
+    data?: TData;
+}
+export type FabricEventCallback = (event: FabricEvent) => void | Promise<void>;
+export type ApprovalDecision = 'approved' | 'denied';
+export interface ApprovalRequest {
+    id: string;
+    sessionId: string;
+    reason: string;
+    subject: string;
+    kind: 'tool' | 'command';
+    risk?: 'low' | 'medium' | 'high';
+    requiredApprovals?: number;
+    escalation?: {
+        afterMs: number;
+        notify?: string[];
+        risk?: 'low' | 'medium' | 'high';
+    };
+    matchedPattern?: string;
+    envKeys?: string[];
+    affectedPaths?: string[];
+    tool?: string;
+    command?: string;
+    input?: JsonValue;
+    actor?: FabricActor;
+    createdAt: string;
+}
+export interface ApprovalResponse {
+    decision: ApprovalDecision;
+    reason?: string;
+}
+export type ApprovalStateStatus = 'pending' | 'approved' | 'denied' | 'expired';
+export interface ApprovalVote {
+    approvalId: string;
+    actor: ActorIdentity | string;
+    decision: ApprovalDecision;
+    reason?: string;
+    votedAt: string;
+}
+export interface ApprovalState {
+    id: string;
+    sessionId: string;
+    status: ApprovalStateStatus;
+    requiredApprovals: number;
+    approvedCount: number;
+    deniedCount: number;
+    votes: ApprovalVote[];
+    request: ApprovalRequest;
+    resolvedAt?: string;
+    resolutionReason?: string;
+}
+export interface ApprovalOptions {
+    timeoutMs?: number;
+}
+export type ApprovalCallback = (request: ApprovalRequest) => ApprovalResponse | ApprovalDecision | boolean | Promise<ApprovalResponse | ApprovalDecision | boolean>;
+export interface ResultExtractionOptions {
+    startDelimiter?: string;
+    endDelimiter?: string;
+    parseJson?: boolean;
+    required?: boolean;
+}
+export interface ResultValidator<TResult = unknown> {
+    parse?: (value: unknown) => TResult;
+    safeParse?: (value: unknown) => {
+        success: true;
+        data: TResult;
+    } | {
+        success: false;
+        error: unknown;
+    };
+    validate?: (value: unknown) => TResult | Promise<TResult>;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,WAAW,CAAC;AAClD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAClD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAChD,OAAO,KAAK,EAAE,WAAW,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;AACnE,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AACpD,OAAO,KAAK,EAAE,UAAU,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAC/D,OAAO,KAAK,EAAE,OAAO,EAAE,SAAS,EAAE,QAAQ,EAAE,OAAO,EAAE,MAAM,YAAY,CAAC;AAExE,MAAM,MAAM,aAAa,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,IAAI,CAAC;AAC7D,MAAM,MAAM,SAAS,GAAG,aAAa,GAAG,SAAS,EAAE,GAAG;IAAE,CAAC,GAAG,EAAE,MAAM,GAAG,SAAS,CAAA;CAAE,CAAC;AACnF,MAAM,MAAM,UAAU,GAAG;IAAE,CAAC,GAAG,EAAE,MAAM,GAAG,SAAS,CAAA;CAAE,CAAC;AAEtD,MAAM,WAAW,aAAa;IAC5B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,CAAC,EAAE,MAAM,GAAG,OAAO,GAAG,SAAS,GAAG,QAAQ,CAAC;IAC/C,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,WAAW;IAC1B,OAAO,CAAC,EAAE,MAAM,GAAG,aAAa,CAAC;IACjC,UAAU,CAAC,EAAE,MAAM,GAAG,aAAa,CAAC;IACpC,QAAQ,CAAC,EAAE,MAAM,GAAG,aAAa,CAAC;CACnC;AAED;;;;;;;;;;;;;GAaG;AACH,MAAM,MAAM,aAAa,GAAG,QAAQ,GAAG,WAAW,GAAG,UAAU,CAAC;AAChE,MAAM,MAAM,YAAY,GAAG,YAAY,GAAG,aAAa,CAAC;AACxD,MAAM,MAAM,oBAAoB,GAAG,QAAQ,GAAG,MAAM,CAAC;AACrD,MAAM,MAAM,2BAA2B,GAAG,MAAM,GAAG,MAAM,GAAG,MAAM,CAAC;AACnE,MAAM,MAAM,yBAAyB,GAAG,MAAM,CAAC;AAE/C,MAAM,WAAW,eAAe;IAC9B;;;;OAIG;IACH,IAAI,CAAC,EAAE,YAAY,CAAC;IACpB,cAAc,CAAC,EAAE,oBAAoB,CAAC;IACtC,qBAAqB,CAAC,EAAE,2BAA2B,CAAC;IACpD,mBAAmB,CAAC,EAAE,yBAAyB,CAAC;CACjD;AAED,MAAM,MAAM,cAAc,GACtB,OAAO,GACP,OAAO,GACP,QAAQ,GACR,sBAAsB,GACtB,2BAA2B,GAC3B,KAAK,GACL,YAAY,GACZ,KAAK,GACL,SAAS,GACT,YAAY,GACZ,OAAO,GACP,YAAY,GACZ,aAAa,CAAC;AAElB,MAAM,WAAW,aAAa,CAAC,QAAQ,GAAG,UAAU;IAClD,IAAI,EAAE,CAAC,OAAO,CAAC,EAAE,SAAS,KAAK,OAAO,CAAC,WAAW,CAAC,CAAC;IACpD,OAAO,EAAE,QAAQ,CAAC;IAClB,GAAG,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC,CAAC;IACzC,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAED,MAAM,WAAW,SAAS;IACxB,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,WAAW,CAAC;IACpB,aAAa,CAAC,EAAE,aAAa,CAAC;IAC9B,SAAS,CAAC,EAAE,eAAe,CAAC;IAC5B,WAAW,CAAC,EAAE,gBAAgB,CAAC;IAC/B,OAAO,CAAC,EAAE,aAAa,CAAC;IACxB,OAAO,CAAC,EAAE,cAAc,GAAG,cAAc,GAAG,UAAU,CAAC;IACvD,IAAI,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB,KAAK,CAAC,EAAE,IAAI,EAAE,CAAC;IACf,MAAM,CAAC,EAAE,KAAK,EAAE,CAAC;IACjB,KAAK,CAAC,EAAE,OAAO,EAAE,CAAC;IAClB,QAAQ,CAAC,EAAE,OAAO,EAAE,CAAC;IACrB,MAAM,CAAC,EAAE,gBAAgB,CAAC;IAC1B,KAAK,CAAC,EAAE,YAAY,CAAC;IACrB,QAAQ,CAAC,EAAE,UAAU,CAAC;IACtB,KAAK,CAAC,EAAE,WAAW,CAAC;IACpB,QAAQ,CAAC,EAAE,eAAe,CAAC;IAC3B,OAAO,CAAC,EAAE,mBAAmB,CAAC;IAC9B,aAAa,CAAC,EAAE,CAAC,GAAG,EAAE,SAAS,KAAK,MAAM,GAAG,SAAS,GAAG,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,CAAC;IACrF,UAAU,CAAC,EAAE,gBAAgB,CAAC;CAC/B;AAED,MAAM,WAAW,WAAW;IAC1B,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC9B,OAAO,CAAC,EAAE,CAAC,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,cAAc,GAAG,OAAO,CAAC,aAAa,CAAC,CAAC;CACxE;AAED,MAAM,WAAW,cAAc;IAC7B,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,IAAI,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB,KAAK,CAAC,EAAE,WAAW,CAAC;IACpB,aAAa,CAAC,EAAE,aAAa,CAAC;IAC9B,SAAS,CAAC,EAAE,eAAe,CAAC;IAC5B,WAAW,CAAC,EAAE,gBAAgB,CAAC;IAC/B,KAAK,CAAC,EAAE,YAAY,CAAC;IACrB,KAAK,CAAC,EAAE,IAAI,EAAE,CAAC;IACf,MAAM,CAAC,EAAE,KAAK,EAAE,CAAC;IACjB,OAAO,CAAC,EAAE,cAAc,GAAG,cAAc,GAAG,UAAU,CAAC;IACvD,KAAK,CAAC,EAAE,OAAO,EAAE,CAAC;IAClB,QAAQ,CAAC,EAAE,OAAO,EAAE,CAAC;IACrB,MAAM,CAAC,EAAE,gBAAgB,CAAC;IAC1B,QAAQ,CAAC,EAAE,UAAU,CAAC;IACtB,KAAK,CAAC,EAAE,WAAW,CAAC;IACpB,QAAQ,CAAC,EAAE,eAAe,CAAC;IAC3B,OAAO,CAAC,EAAE,mBAAmB,CAAC;IAC9B,aAAa,CAAC,EAAE,CAAC,GAAG,EAAE,SAAS,KAAK,MAAM,GAAG,SAAS,GAAG,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,CAAC;IACrF,UAAU,CAAC,EAAE,gBAAgB,CAAC;IAC9B,iBAAiB,CAAC,EAAE,MAAM,CAAC;CAC5B;AAED,MAAM,WAAW,aAAa,CAAC,OAAO,GAAG,OAAO;IAC9C,IAAI,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB,KAAK,CAAC,EAAE,WAAW,CAAC;IACpB,aAAa,CAAC,EAAE,aAAa,CAAC;IAC9B,SAAS,CAAC,EAAE,eAAe,CAAC;IAC5B,KAAK,CAAC,EAAE,OAAO,EAAE,CAAC;IAClB,QAAQ,CAAC,EAAE,OAAO,EAAE,CAAC;IACrB,MAAM,CAAC,EAAE,gBAAgB,CAAC;IAC1B,SAAS,CAAC,EAAE,QAAQ,EAAE,CAAC;IACvB,WAAW,CAAC,EAAE,gBAAgB,CAAC;IAC/B,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,mBAAmB,CAAC,EAAE,MAAM,CAAC;IAC7B,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,2BAA2B,CAAC,EAAE,MAAM,CAAC;IACrC,sBAAsB,CAAC,EAAE,OAAO,CAAC;IACjC,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,MAAM,CAAC,EAAE,WAAW,CAAC;IACrB,OAAO,CAAC,EAAE,mBAAmB,CAAC;IAC9B,UAAU,CAAC,EAAE,gBAAgB,CAAC;IAC9B,MAAM,CAAC,EAAE,eAAe,CAAC,OAAO,CAAC,CAAC;IAClC,gBAAgB,CAAC,EAAE,OAAO,GAAG,uBAAuB,CAAC;IACrD,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,EAAE,UAAU,CAAC;IACtB,QAAQ,CAAC,EAAE,eAAe,CAAC;CAC5B;AAED,MAAM,WAAW,YAAY,CAAC,OAAO,GAAG,OAAO,CAAE,SAAQ,aAAa,CAAC,OAAO,CAAC;IAC7E,IAAI,CAAC,EAAE,UAAU,CAAC;CACnB;AAED,MAAM,WAAW,WAAW,CAAC,OAAO,GAAG,OAAO,CAAE,SAAQ,aAAa,CAAC,OAAO,CAAC;IAC5E,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,0FAA0F;IAC1F,UAAU,CAAC,EAAE,OAAO,GAAG,MAAM,CAAC;IAC9B,QAAQ,CAAC,EAAE,UAAU,CAAC;CACvB;AAED,MAAM,WAAW,YAAY;IAC3B,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,GAAG,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC7B,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,MAAM,CAAC,EAAE,WAAW,CAAC;IACrB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,MAAM,CAAC,EAAE,gBAAgB,CAAC;IAC1B,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,UAAU,CAAC,EAAE,gBAAgB,CAAC;CAC/B;AAED,MAAM,WAAW,WAAW;IAC1B,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,KAAK;IACpB,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,QAAQ,CAAC,EAAE,UAAU,CAAC;CACvB;AAED,MAAM,WAAW,IAAI;IACnB,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,UAAU,CAAC;CACvB;AAED,MAAM,WAAW,qBAAqB;IACpC,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,EAAE,UAAU,CAAC;CACvB;AAED,MAAM,WAAW,WAAW;IAC1B,EAAE,EAAE,MAAM,CAAC;IACX,SAAS,EAAE,MAAM,CAAC;IAClB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;IAClB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,QAAQ,CAAC,EAAE,UAAU,CAAC;CACvB;AAED,MAAM,WAAW,YAAY;IAC3B,IAAI,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,GAAG,SAAS,CAAC,CAAC;IACnD,IAAI,CAAC,IAAI,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACvC,8DAA8D;IAC9D,YAAY,CAAC,IAAI,OAAO,CAAC,WAAW,EAAE,CAAC,CAAC;IACxC,WAAW,CAAC,CAAC,SAAS,EAAE,MAAM,EAAE,KAAK,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACnE,WAAW,CAAC,CAAC,SAAS,EAAE,MAAM,EAAE,KAAK,EAAE,YAAY,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACpE,eAAe,CAAC,CAAC,SAAS,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,SAAS,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,gBAAgB,GAAG,SAAS,CAAC,CAAC;IACnH,eAAe,CAAC,CAAC,SAAS,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,QAAQ,EAAE,gBAAgB,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACnG,YAAY,CAAC,CAAC,SAAS,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,IAAI,EAAE,YAAY,GAAG,OAAO,CAAC,aAAa,CAAC,CAAC;IACjG,gBAAgB,CAAC,CAAC,SAAS,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,GAAG,SAAS,CAAC,CAAC;IAC7F,kBAAkB,CAAC,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,EAAE,CAAC,CAAC;IACjE,WAAW,CAAC,CAAC,SAAS,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,UAAU,EAAE,OAAO,CAAC,EAAE,qBAAqB,GAAG,OAAO,CAAC,WAAW,CAAC,CAAC;IACnI,WAAW,CAAC,CAAC,SAAS,EAAE,MAAM,EAAE,gBAAgB,EAAE,MAAM,GAAG,OAAO,CAAC;QAAE,GAAG,EAAE,WAAW,CAAC;QAAC,OAAO,EAAE,UAAU,CAAA;KAAE,GAAG,SAAS,CAAC,CAAC;IAC1H,aAAa,CAAC,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,EAAE,CAAC,CAAC;CAC3D;AAED,MAAM,MAAM,gBAAgB,GACxB,aAAa,GACb,mBAAmB,GACnB,eAAe,GACf,WAAW,GACX,aAAa,GACb,eAAe,GACf,cAAc,GACd,YAAY,GACZ,iBAAiB,GACjB,UAAU,GACV,aAAa,GACb,gBAAgB,GAChB,kBAAkB,GAClB,QAAQ,GACR,aAAa,GACb,WAAW,GACX,oBAAoB,GACpB,qBAAqB,GACrB,YAAY,GACZ,oBAAoB,GACpB,gBAAgB,GAChB,kBAAkB,GAClB,iBAAiB,GACjB,kBAAkB,GAClB,QAAQ,GACR,cAAc,GACd,iBAAiB,GACjB,OAAO,CAAC;AAEZ,MAAM,WAAW,YAAY,CAAC,KAAK,GAAG,UAAU;IAC9C,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,gBAAgB,CAAC;IACvB,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,KAAK,CAAC,EAAE,WAAW,CAAC;IACpB,IAAI,CAAC,EAAE,KAAK,CAAC;CACd;AAED,MAAM,WAAW,WAAW;IAC1B,EAAE,EAAE,MAAM,CAAC;IACX,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,CAAC,EAAE,UAAU,CAAC;IACtB,MAAM,CAAC,EAAE,WAAW,EAAE,CAAC;IACvB,OAAO,CAAC,EAAE,YAAY,EAAE,CAAC;IACzB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,uBAAuB;IACtC,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,CAAC,EAAE,UAAU,CAAC;CACvB;AAED,MAAM,WAAW,wBAAwB;IACvC,KAAK,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,gBAAgB;IAC/B,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,iBAAiB;IAChC,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,eAAe,CAAC,EAAE,OAAO,CAAC;CAC3B;AAED,MAAM,WAAW,gBAAgB;IAC/B,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,gBAAgB,EAAE,MAAM,CAAC;IACzB,gBAAgB,CAAC,EAAE,MAAM,CAAC;CAC3B;AAED,MAAM,MAAM,eAAe,GACvB,YAAY,GACZ,YAAY,GACZ,UAAU,GACV,eAAe,GACf,aAAa,GACb,eAAe,GACf,cAAc,GACd,YAAY,GACZ,aAAa,GACb,WAAW,GACX,YAAY,GACZ,iBAAiB,GACjB,UAAU,GACV,aAAa,GACb,gBAAgB,GAChB,kBAAkB,GAClB,QAAQ,GACR,eAAe,GACf,aAAa,GACb,YAAY,GACZ,UAAU,GACV,oBAAoB,GACpB,qBAAqB,GACrB,YAAY,GACZ,oBAAoB,GACpB,gBAAgB,GAChB,kBAAkB,GAClB,iBAAiB,GACjB,kBAAkB,GAClB,OAAO,GACP,cAAc,GACd,QAAQ,CAAC;AAEb,MAAM,WAAW,WAAW,CAAC,KAAK,GAAG,UAAU;IAC7C,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,eAAe,CAAC;IACtB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,IAAI,CAAC,EAAE,KAAK,CAAC;CACd;AAED,MAAM,MAAM,mBAAmB,GAAG,CAAC,KAAK,EAAE,WAAW,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;AAE/E,MAAM,MAAM,gBAAgB,GAAG,UAAU,GAAG,QAAQ,CAAC;AAErD,MAAM,WAAW,eAAe;IAC9B,EAAE,EAAE,MAAM,CAAC;IACX,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,GAAG,SAAS,CAAC;IACzB,IAAI,CAAC,EAAE,KAAK,GAAG,QAAQ,GAAG,MAAM,CAAC;IACjC,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,UAAU,CAAC,EAAE;QACX,OAAO,EAAE,MAAM,CAAC;QAChB,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;QAClB,IAAI,CAAC,EAAE,KAAK,GAAG,QAAQ,GAAG,MAAM,CAAC;KAClC,CAAC;IACF,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;IACnB,aAAa,CAAC,EAAE,MAAM,EAAE,CAAC;IACzB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,KAAK,CAAC,EAAE,SAAS,CAAC;IAClB,KAAK,CAAC,EAAE,WAAW,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,EAAE,gBAAgB,CAAC;IAC3B,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,MAAM,mBAAmB,GAAG,SAAS,GAAG,UAAU,GAAG,QAAQ,GAAG,SAAS,CAAC;AAEhF,MAAM,WAAW,YAAY;IAC3B,UAAU,EAAE,MAAM,CAAC;IACnB,KAAK,EAAE,aAAa,GAAG,MAAM,CAAC;IAC9B,QAAQ,EAAE,gBAAgB,CAAC;IAC3B,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,aAAa;IAC5B,EAAE,EAAE,MAAM,CAAC;IACX,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,mBAAmB,CAAC;IAC5B,iBAAiB,EAAE,MAAM,CAAC;IAC1B,aAAa,EAAE,MAAM,CAAC;IACtB,WAAW,EAAE,MAAM,CAAC;IACpB,KAAK,EAAE,YAAY,EAAE,CAAC;IACtB,OAAO,EAAE,eAAe,CAAC;IACzB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,gBAAgB,CAAC,EAAE,MAAM,CAAC;CAC3B;AAED,MAAM,WAAW,eAAe;IAC9B,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,MAAM,gBAAgB,GAAG,CAAC,OAAO,EAAE,eAAe,KAAK,gBAAgB,GAAG,gBAAgB,GAAG,OAAO,GAAG,OAAO,CAAC,gBAAgB,GAAG,gBAAgB,GAAG,OAAO,CAAC,CAAC;AAEpK,MAAM,WAAW,uBAAuB;IACtC,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB;AAED,MAAM,WAAW,eAAe,CAAC,OAAO,GAAG,OAAO;IAChD,KAAK,CAAC,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,OAAO,CAAC;IACpC,SAAS,CAAC,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK;QAAE,OAAO,EAAE,IAAI,CAAC;QAAC,IAAI,EAAE,OAAO,CAAA;KAAE,GAAG;QAAE,OAAO,EAAE,KAAK,CAAC;QAAC,KAAK,EAAE,OAAO,CAAA;KAAE,CAAC;IACtG,QAAQ,CAAC,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;CAC3D"}

package/dist/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":""}

package/package.json

@@ -0,0 +1,71 @@
+{
+  "name": "@fabric-harness/sdk",
+  "version": "0.1.0",
+  "description": "Headless TypeScript framework for building durable, deployable autonomous agents — core SDK.",
+  "license": "Apache-2.0",
+  "author": "Fabric",
+  "homepage": "https://github.com/Fabric-Pro/fabric-harness#readme",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/Fabric-Pro/fabric-harness.git",
+    "directory": "packages/sdk"
+  },
+  "bugs": {
+    "url": "https://github.com/Fabric-Pro/fabric-harness/issues"
+  },
+  "keywords": [
+    "agents",
+    "ai",
+    "framework",
+    "anthropic",
+    "openai",
+    "mcp",
+    "sandbox",
+    "tool-use"
+  ],
+  "type": "module",
+  "sideEffects": false,
+  "engines": {
+    "node": ">=22.0.0"
+  },
+  "publishConfig": {
+    "registry": "https://registry.npmjs.org",
+    "access": "public"
+  },
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    },
+    "./lite": {
+      "types": "./dist/lite.d.ts",
+      "import": "./dist/lite.js"
+    }
+  },
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE"
+  ],
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.29.0"
+  },
+  "peerDependencies": {
+    "@opentelemetry/api": "^1.9.1"
+  },
+  "peerDependenciesMeta": {
+    "@opentelemetry/api": {
+      "optional": true
+    }
+  },
+  "devDependencies": {
+    "@opentelemetry/api": "^1.9.1",
+    "vitest": "^4.1.5"
+  },
+  "scripts": {
+    "build": "tsc -p tsconfig.json",
+    "check": "tsc -b tsconfig.json",
+    "test": "vitest run",
+    "test:watch": "vitest"
+  }
+}