@compozy/extension-sdk 0.3.0-beta.10

package/dist/types/testing/harness.d.ts

@@ -0,0 +1,51 @@
+import { Extension } from "../extension.js";
+import type { ExtensionDescribeProcess } from "../extension-contract.js";
+import type { InitializeRequest, InitializeResponse, InitializeRuntime } from "../types.js";
+import { MockTransport } from "./mock-transport.js";
+export interface HarnessLoadOptions {
+    sourceTier?: "bundled" | "user" | "workspace" | "marketplace";
+    provides?: string[];
+    grantedPermissions?: string[];
+    grantedResourceKinds?: string[];
+    grantedResourceScopes?: ("global" | "workspace")[];
+    sessionNonce?: string;
+    daemonRequests?: string[];
+    extensionServices?: string[];
+    compozyVersion?: string;
+    runtime?: Partial<InitializeRuntime>;
+}
+export interface ExtensionFactoryOptions {
+    transport?: MockTransport;
+    stderr?: NodeJS.WritableStream;
+}
+type ExtensionFactory = Extension | ((options: ExtensionFactoryOptions) => Extension | Promise<Extension>);
+export declare class TestHarness {
+    private readonly mockedHostHandlers;
+    private readonly stderr;
+    private hostTransport;
+    private extensionTransport;
+    private extension;
+    private initializeRequest;
+    private initializeResponse;
+    private describeStdout;
+    private describeExitCode;
+    constructor(options?: {
+        stderr?: NodeJS.WritableStream;
+    });
+    mockHostAPI<TResult = unknown>(method: string, handler: (params: unknown) => TResult | Promise<TResult>): this;
+    loadExtension(target: string | ExtensionFactory, options?: HarnessLoadOptions): Promise<Extension>;
+    call<TResult = unknown>(method: string, params?: unknown): Promise<TResult>;
+    getLastInitializeRequest(): InitializeRequest | undefined;
+    getLastInitializeResponse(): InitializeResponse | undefined;
+    getHostTransport(): MockTransport;
+    captureDescribeProcess(argv?: readonly string[]): ExtensionDescribeProcess;
+    getDescribeResult(): {
+        stdout: string;
+        exitCode: number | undefined;
+    };
+    private bindMockedHostHandler;
+    private resolveExtension;
+    private buildInitializeRequest;
+}
+export {};
+//# sourceMappingURL=harness.d.ts.map

package/dist/types/testing/harness.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"harness.d.ts","sourceRoot":"","sources":["../../../src/testing/harness.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAC5C,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,0BAA0B,CAAC;AACzE,OAAO,KAAK,EAGV,iBAAiB,EACjB,kBAAkB,EAClB,iBAAiB,EAElB,MAAM,aAAa,CAAC;AACrB,OAAO,EAAE,aAAa,EAA2B,MAAM,qBAAqB,CAAC;AAE7E,MAAM,WAAW,kBAAkB;IACjC,UAAU,CAAC,EAAE,SAAS,GAAG,MAAM,GAAG,WAAW,GAAG,aAAa,CAAC;IAC9D,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;IACpB,kBAAkB,CAAC,EAAE,MAAM,EAAE,CAAC;IAC9B,oBAAoB,CAAC,EAAE,MAAM,EAAE,CAAC;IAChC,qBAAqB,CAAC,EAAE,CAAC,QAAQ,GAAG,WAAW,CAAC,EAAE,CAAC;IACnD,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,cAAc,CAAC,EAAE,MAAM,EAAE,CAAC;IAC1B,iBAAiB,CAAC,EAAE,MAAM,EAAE,CAAC;IAC7B,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,OAAO,CAAC,EAAE,OAAO,CAAC,iBAAiB,CAAC,CAAC;CACtC;AAED,MAAM,WAAW,uBAAuB;IACtC,SAAS,CAAC,EAAE,aAAa,CAAC;IAC1B,MAAM,CAAC,EAAE,MAAM,CAAC,cAAc,CAAC;CAChC;AAED,KAAK,gBAAgB,GACjB,SAAS,GACT,CAAC,CAAC,OAAO,EAAE,uBAAuB,KAAK,SAAS,GAAG,OAAO,CAAC,SAAS,CAAC,CAAC,CAAC;AAiB3E,qBAAa,WAAW;IACtB,OAAO,CAAC,QAAQ,CAAC,kBAAkB,CAG/B;IACJ,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAwB;IAC/C,OAAO,CAAC,aAAa,CAA4B;IACjD,OAAO,CAAC,kBAAkB,CAA4B;IACtD,OAAO,CAAC,SAAS,CAAwB;IACzC,OAAO,CAAC,iBAAiB,CAAgC;IACzD,OAAO,CAAC,kBAAkB,CAAiC;IAC3D,OAAO,CAAC,cAAc,CAAM;IAC5B,OAAO,CAAC,gBAAgB,CAAqB;IAE7C,YAAmB,OAAO,GAAE;QAAE,MAAM,CAAC,EAAE,MAAM,CAAC,cAAc,CAAA;KAAO,EAElE;IAEM,WAAW,CAAC,OAAO,GAAG,OAAO,EAClC,MAAM,EAAE,MAAM,EACd,OAAO,EAAE,CAAC,MAAM,EAAE,OAAO,KAAK,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,GACvD,IAAI,CAIN;IAEY,aAAa,CACxB,MAAM,EAAE,MAAM,GAAG,gBAAgB,EACjC,OAAO,GAAE,kBAAuB,GAC/B,OAAO,CAAC,SAAS,CAAC,CA4BpB;IAEY,IAAI,CAAC,OAAO,GAAG,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,CAKvF;IAEM,wBAAwB,IAAI,iBAAiB,GAAG,SAAS,CAE/D;IAEM,yBAAyB,IAAI,kBAAkB,GAAG,SAAS,CAEjE;IAEM,gBAAgB,IAAI,aAAa,CAKvC;IAEM,sBAAsB,CAC3B,IAAI,GAAE,SAAS,MAAM,EAAgC,GACpD,wBAAwB,CAe1B;IAEM,iBAAiB,IAAI;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,GAAG,SAAS,CAAA;KAAE,CAE3E;IAED,OAAO,CAAC,qBAAqB;YAUf,gBAAgB;IA+B9B,OAAO,CAAC,sBAAsB;CAyC/B"}

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

@@ -0,0 +1,4 @@
+export { TestHarness } from "./harness.js";
+export { publicProvideFixtures, validateProvideConformance, type ProvideFixture, } from "./conformance.js";
+export { MockTransport, createMockTransportPair } from "./mock-transport.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/types/testing/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/testing/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAC3C,OAAO,EACL,qBAAqB,EACrB,0BAA0B,EAC1B,KAAK,cAAc,GACpB,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EAAE,aAAa,EAAE,uBAAuB,EAAE,MAAM,qBAAqB,CAAC"}

package/dist/types/testing/mock-transport.d.ts

@@ -0,0 +1,29 @@
+import type { JSONRPCID } from "../types.js";
+import type { TransportHandler, TransportLike } from "../transport.js";
+interface RecordedRequest {
+    id: JSONRPCID;
+    method: string;
+    params: unknown;
+}
+export declare class MockTransport implements TransportLike {
+    private readonly handlers;
+    private readonly errors;
+    private nextID;
+    private started;
+    private closed;
+    private peer;
+    readonly requests: RecordedRequest[];
+    connect(peer: MockTransport): void;
+    start(): void;
+    handle(method: string, handler: TransportHandler): void;
+    unhandle(method: string): void;
+    onTransportError(listener: (error: Error) => void): () => void;
+    close(): Promise<void>;
+    call<TResult = unknown>(method: string, params?: unknown): Promise<TResult>;
+}
+export declare function createMockTransportPair(): {
+    host: MockTransport;
+    extension: MockTransport;
+};
+export {};
+//# sourceMappingURL=mock-transport.d.ts.map

package/dist/types/testing/mock-transport.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mock-transport.d.ts","sourceRoot":"","sources":["../../../src/testing/mock-transport.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,SAAS,EAA0B,MAAM,aAAa,CAAC;AACrE,OAAO,KAAK,EAAE,gBAAgB,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAEvE,UAAU,eAAe;IACvB,EAAE,EAAE,SAAS,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,OAAO,CAAC;CACjB;AAED,qBAAa,aAAc,YAAW,aAAa;IACjD,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAuC;IAChE,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAqC;IAC5D,OAAO,CAAC,MAAM,CAAK;IACnB,OAAO,CAAC,OAAO,CAAS;IACxB,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,IAAI,CAA4B;IAExC,SAAgB,QAAQ,EAAE,eAAe,EAAE,CAAM;IAE1C,OAAO,CAAC,IAAI,EAAE,aAAa,GAAG,IAAI,CAExC;IAEM,KAAK,IAAI,IAAI,CAEnB;IAEM,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,gBAAgB,GAAG,IAAI,CAE7D;IAEM,QAAQ,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAEpC;IAEM,gBAAgB,CAAC,QAAQ,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,IAAI,GAAG,MAAM,IAAI,CAKpE;IAEY,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAElC;IAEY,IAAI,CAAC,OAAO,GAAG,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,CAoCvF;CACF;AAED,wBAAgB,uBAAuB,IAAI;IACzC,IAAI,EAAE,aAAa,CAAC;IACpB,SAAS,EAAE,aAAa,CAAC;CAC1B,CAMA"}

package/dist/types/transport.d.ts

@@ -0,0 +1,58 @@
+import type { Readable, Writable } from "node:stream";
+import type { JSONRPCRequestEnvelope } from "./types.js";
+export declare const DEFAULT_MAX_MESSAGE_BYTES: number;
+export declare const JSON_RPC_VERSION = "2.0";
+export type TransportHandler = (params: unknown, request: JSONRPCRequestEnvelope) => Promise<unknown> | unknown;
+export interface TransportLike {
+    call<TResult = unknown>(method: string, params?: unknown): Promise<TResult>;
+    handle(method: string, handler: TransportHandler): void;
+    unhandle(method: string): void;
+    onTransportError(listener: (error: Error) => void): () => void;
+    start(): void;
+    close(): Promise<void>;
+}
+interface StdioTransportOptions {
+    input?: Readable;
+    output?: Writable;
+    maxMessageBytes?: number;
+}
+export declare class StdioTransport implements TransportLike {
+    private readonly input;
+    private readonly output;
+    private readonly maxMessageBytes;
+    private readonly handlers;
+    private readonly pending;
+    private readonly errorListeners;
+    private readBuffer;
+    private nextID;
+    private started;
+    private closed;
+    private readonly onDataBound;
+    private readonly onErrorBound;
+    private readonly onEndBound;
+    constructor(options?: StdioTransportOptions);
+    start(): void;
+    handle(method: string, handler: TransportHandler): void;
+    unhandle(method: string): void;
+    onTransportError(listener: (error: Error) => void): () => void;
+    close(): Promise<void>;
+    call<TResult = unknown>(method: string, params?: unknown): Promise<TResult>;
+    private handleChunk;
+    private processLine;
+    private dispatchRequest;
+    private dispatchResponse;
+    private sendResult;
+    private sendError;
+    private writeFrame;
+    private fail;
+}
+export declare class NotReadyTransport implements TransportLike {
+    handle(): void;
+    unhandle(_method: string): void;
+    onTransportError(): () => void;
+    start(): void;
+    close(): Promise<void>;
+    call(_method?: string, _params?: unknown): Promise<never>;
+}
+export {};
+//# sourceMappingURL=transport.d.ts.map

package/dist/types/transport.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"transport.d.ts","sourceRoot":"","sources":["../../src/transport.ts"],"names":[],"mappings":"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"}

package/dist/types/types.d.ts

@@ -0,0 +1,115 @@
+import type { JSONValue } from "./base-types.js";
+import type { HookEvent, HookExecutorKind, HookMatcher, HookMode, HookPatchByEvent, HookPayloadByEvent, HostAPIMethod, DescribeSubprocess, DescribeResources, DescribeNetworkParticipation, ExtensionCommandGroupSpec, ExtensionCommandSpec, RiskClass, SourceKind, ToolID, ToolsetID, Visibility } from "./generated/contracts.js";
+export * from "./base-types.js";
+export * from "./generated/contracts.js";
+export type ToolSource = SourceKind;
+export type ExtensionSourceTier = "bundled" | "user" | "workspace" | "marketplace";
+export interface HookExecutorConfig {
+    kind?: HookExecutorKind;
+    command?: string;
+    args?: string[];
+    env?: Record<string, string>;
+}
+export interface HookConfig {
+    name: string;
+    event: HookEvent;
+    mode?: HookMode;
+    required?: boolean;
+    priority?: number;
+    timeout?: string;
+    matcher?: HookMatcher;
+    command?: string;
+    args?: string[];
+    env?: Record<string, string>;
+    executor?: HookExecutorConfig;
+}
+export interface MCPServerConfig {
+    command: string;
+    args?: string[];
+    env?: Record<string, string>;
+}
+export interface ToolConfig {
+    id?: ToolID;
+    display_title?: string;
+    description?: string;
+    input_schema?: JSONValue;
+    output_schema?: JSONValue;
+    handler?: string;
+    backend?: {
+        kind?: "extension_host" | "mcp";
+        handler?: string;
+        server?: string;
+        tool?: string;
+    };
+    visibility?: Visibility;
+    risk?: RiskClass;
+    read_only?: boolean;
+    destructive?: boolean;
+    open_world?: boolean;
+    requires_interaction?: boolean;
+    concurrency_safe?: boolean;
+    max_result_bytes?: number;
+    toolsets?: ToolsetID[];
+    tags?: string[];
+    search_hints?: string[];
+    required_capabilities?: string[];
+    command?: ExtensionCommandSpec;
+}
+export interface ResourcesConfig extends DescribeResources {
+    hooks?: HookConfig[];
+    tools?: Record<string, ToolConfig>;
+    command_groups?: ExtensionCommandGroupSpec[];
+    mcp_servers?: Record<string, MCPServerConfig>;
+}
+export interface CapabilitiesConfig {
+    provides?: string[];
+}
+export interface PermissionsConfig {
+    requires?: HostAPIMethod[];
+}
+export interface SubprocessConfig {
+    command?: string;
+    args?: string[];
+    env?: Record<string, string>;
+    health_check_interval?: string;
+    shutdown_timeout?: string;
+}
+export interface ExtensionManifest {
+    name: string;
+    version: string;
+    description?: string;
+    min_compozy_version?: string;
+    resources?: ResourcesConfig;
+    capabilities?: CapabilitiesConfig;
+    permissions?: PermissionsConfig;
+    subprocess?: SubprocessConfig;
+    network_participation?: DescribeNetworkParticipation;
+}
+export interface ExtensionDefinition extends Pick<ExtensionManifest, "name" | "version" | "description" | "capabilities" | "permissions"> {
+    requires_env?: string[];
+    resources?: DescribeResources;
+    subprocess?: DescribeSubprocess;
+    supported_hook_events?: HookEvent[];
+    network_participation?: DescribeNetworkParticipation;
+}
+export interface HealthCheckResult {
+    healthy: boolean;
+    message?: string;
+    details?: Record<string, JSONValue>;
+}
+export interface HookInvocation<TEvent extends HookEvent = HookEvent> {
+    name: string;
+    event: TEvent;
+    mode: HookMode;
+    required: boolean;
+    timeout_ms: number;
+    source: string;
+    metadata?: Record<string, string>;
+}
+export interface ExecuteHookParams<TEvent extends HookEvent = HookEvent> {
+    invocation_id: string;
+    hook: HookInvocation<TEvent>;
+    payload: HookPayloadByEvent[TEvent];
+}
+export type ExecuteHookResult<TEvent extends HookEvent = HookEvent> = HookPatchByEvent[TEvent];
+//# sourceMappingURL=types.d.ts.map

package/dist/types/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/types.ts"],"names":[],"mappings":"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"}

package/dist/types/watch-source.d.ts

@@ -0,0 +1,59 @@
+import type { HostAPI } from "./host-api.js";
+import type { ExtensionContext, ExtensionSession } from "./extension.js";
+import type { ExtensionDefinition, JSONRPCRequestEnvelope, JSONValue } from "./types.js";
+export declare const WATCH_SOURCE_CAPABILITY = "loop.watch_source";
+export declare const WATCH_POLL_METHOD = "watch/poll";
+export interface ExtensionWatchSourceOptions {
+}
+export interface WatchPollRequest {
+    spec: JSONValue;
+    expected_state_digest?: string;
+}
+export interface WatchPollResponse {
+    ready: boolean;
+    /** Stable delivery identity; trimmed, NFC-normalized, non-empty, and limited to 256 UTF-8 bytes. */
+    event_key: string;
+    state_digest?: string;
+    payload?: JSONValue;
+    settled_at?: string;
+}
+export interface ExtensionWatchSourceContext<TSpec extends JSONValue = JSONValue> {
+    readonly kind: string;
+    readonly spec: TSpec;
+    readonly expectedStateDigest?: string;
+    readonly context: ExtensionContext;
+    readonly host: HostAPI;
+    readonly session: ExtensionSession;
+}
+export type ExtensionWatchSourceHandler<TSpec extends JSONValue = JSONValue> = (request: ExtensionWatchSourceContext<TSpec>) => Promise<WatchPollResponse> | WatchPollResponse;
+export interface RegisteredWatchSource {
+    kind: string;
+    handler: ExtensionWatchSourceHandler;
+}
+interface ExtensionWatchSourcesOptions {
+    bindMethod: (method: string) => void;
+    hasUserHandler: (method: string) => boolean;
+    makeContext: (request: JSONRPCRequestEnvelope) => ExtensionContext;
+}
+export declare class ExtensionWatchSources {
+    private readonly options;
+    private readonly handlers;
+    constructor(options: ExtensionWatchSourcesOptions);
+    register<TSpec extends JSONValue = JSONValue>(definition: ExtensionDefinition, kind: string, _registerOptions: ExtensionWatchSourceOptions, handler: ExtensionWatchSourceHandler<TSpec>): void;
+    hasHandlers(): boolean;
+    implementedMethods(): string[];
+    bindMethods(): void;
+    kinds(): string[];
+    initializeResponseFields(): {
+        watch_source_kinds?: string[];
+    };
+    handlePoll(request: JSONRPCRequestEnvelope, params: unknown): Promise<WatchPollResponse>;
+    private ensureCapability;
+}
+export declare function isWatchSourceMethod(method: string): boolean;
+export declare function parseWatchPollRequest(params: unknown): WatchPollRequest & {
+    kind: string;
+};
+export declare function normalizeWatchPollResponse(response: WatchPollResponse): WatchPollResponse;
+export {};
+//# sourceMappingURL=watch-source.d.ts.map

package/dist/types/watch-source.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"watch-source.d.ts","sourceRoot":"","sources":["../../src/watch-source.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -0,0 +1,49 @@
+{
+    "name": "@compozy/extension-sdk",
+    "version": "0.3.0-beta.10",
+    "private": false,
+    "description": "TypeScript SDK for building CompozyOS subprocess extensions",
+    "homepage": "https://compozy.com",
+    "bugs": "https://github.com/compozy/compozy/issues",
+    "license": "MIT",
+    "repository": {
+        "type": "git",
+        "url": "git+https://github.com/compozy/compozy.git",
+        "directory": "sdk/typescript"
+    },
+    "files": [
+        "dist/**/*"
+    ],
+    "sideEffects": false,
+    "main": "./dist/cjs/index.js",
+    "module": "./dist/esm/index.js",
+    "types": "./dist/types/index.d.ts",
+    "exports": {
+        ".": {
+            "types": "./dist/types/index.d.ts",
+            "require": "./dist/cjs/index.js",
+            "import": "./dist/esm/index.js"
+        },
+        "./testing": {
+            "types": "./dist/types/testing/index.d.ts",
+            "require": "./dist/cjs/testing/index.js",
+            "import": "./dist/esm/testing/index.js"
+        },
+        "./package.json": "./package.json"
+    },
+    "publishConfig": {
+        "access": "public",
+        "provenance": true,
+        "registry": "https://registry.npmjs.org"
+    },
+    "scripts": {
+        "codegen-check": "bun run --cwd ../.. codegen-check",
+        "build": "rm -rf dist && tsc -p tsconfig.types.json && tsc -p tsconfig.esm.json && tsc -p tsconfig.cjs.json && node ./scripts/postbuild.mjs",
+        "typecheck": "node ../../node_modules/@typescript/native/bin/tsc -p tsconfig.json --noEmit",
+        "test": "vitest run --config vitest.config.ts",
+        "coverage": "vitest run --config vitest.config.ts --coverage"
+    },
+    "engines": {
+        "node": ">=18"
+    }
+}