@compozy/extension-sdk 0.3.0-beta.7 → 0.3.0-beta.9

package/dist/types/extension-provide-surface.d.ts

@@ -0,0 +1,23 @@
+import type { ExtensionDefinition } from "./types.js";
+import type { ExtensionHandler } from "./extension-contract.js";
+export declare const registerProvideSurface: unique symbol;
+export interface ProvideSurfaceRegistration {
+    method: string;
+    handler: ExtensionHandler;
+}
+interface ExtensionProvideSurfacesOptions {
+    handlers: Map<string, ExtensionHandler>;
+    validateMethod: (method: string) => void;
+    bindMethod: (method: string) => void;
+    unbindMethod: (method: string) => void;
+}
+export declare class ExtensionProvideSurfaces {
+    private readonly options;
+    private readonly owners;
+    constructor(options: ExtensionProvideSurfacesOptions);
+    owner(method: string): string | undefined;
+    register(definition: ExtensionDefinition, capability: string, registrations: readonly ProvideSurfaceRegistration[]): void;
+    private validateRegistrations;
+}
+export {};
+//# sourceMappingURL=extension-provide-surface.d.ts.map

package/dist/types/extension-provide-surface.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"extension-provide-surface.d.ts","sourceRoot":"","sources":["../../src/extension-provide-surface.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,YAAY,CAAC;AACtD,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAGhE,eAAO,MAAM,sBAAsB,eAAmC,CAAC;AAEvE,MAAM,WAAW,0BAA0B;IACzC,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,gBAAgB,CAAC;CAC3B;AAED,UAAU,+BAA+B;IACvC,QAAQ,EAAE,GAAG,CAAC,MAAM,EAAE,gBAAgB,CAAC,CAAC;IACxC,cAAc,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,IAAI,CAAC;IACzC,UAAU,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,IAAI,CAAC;IACrC,YAAY,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,IAAI,CAAC;CACxC;AAED,qBAAa,wBAAwB;IAGhB,OAAO,CAAC,QAAQ,CAAC,OAAO;IAF3C,OAAO,CAAC,QAAQ,CAAC,MAAM,CAA6B;IAEpD,YAAoC,OAAO,EAAE,+BAA+B,EAAI;IAEzE,KAAK,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAE/C;IAEM,QAAQ,CACb,UAAU,EAAE,mBAAmB,EAC/B,UAAU,EAAE,MAAM,EAClB,aAAa,EAAE,SAAS,0BAA0B,EAAE,GACnD,IAAI,CA0CN;IAED,OAAO,CAAC,qBAAqB;CAyB9B"}

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

@@ -0,0 +1,16 @@
+import { type ExtensionSession } from "./extension-contract.js";
+import type { ExtensionDefinition, HookEvent, InitializeResponse } from "./types.js";
+interface BuildExtensionSessionOptions {
+    definition: ExtensionDefinition;
+    params: unknown;
+    implementedMethods: string[];
+    supportedHookEvents: HookEvent[];
+    watchSourceKinds: string[];
+    sdkVersion: string;
+}
+export declare function buildExtensionSession(options: BuildExtensionSessionOptions): {
+    response: InitializeResponse;
+    session: ExtensionSession;
+};
+export {};
+//# sourceMappingURL=extension-session.d.ts.map

package/dist/types/extension-session.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"extension-session.d.ts","sourceRoot":"","sources":["../../src/extension-session.ts"],"names":[],"mappings":"AACA,OAAO,EAAY,KAAK,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAG1E,OAAO,KAAK,EAAE,mBAAmB,EAAE,SAAS,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AAErF,UAAU,4BAA4B;IACpC,UAAU,EAAE,mBAAmB,CAAC;IAChC,MAAM,EAAE,OAAO,CAAC;IAChB,kBAAkB,EAAE,MAAM,EAAE,CAAC;IAC7B,mBAAmB,EAAE,SAAS,EAAE,CAAC;IACjC,gBAAgB,EAAE,MAAM,EAAE,CAAC;IAC3B,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,4BAA4B,GAAG;IAC5E,QAAQ,EAAE,kBAAkB,CAAC;IAC7B,OAAO,EAAE,gBAAgB,CAAC;CAC3B,CAyCA"}

package/dist/types/extension.d.ts

@@ -2,6 +2,7 @@ import type { TransportLike } from "./transport.js";
 import { type ExtensionWatchSourceHandler, type ExtensionWatchSourceOptions } from "./watch-source.js";
 import { HostAPI } from "./host-api.js";
 import type { ExtensionDefinition, HookEvent, ExtensionToolRuntimeDescriptor, JSONValue } from "./types.js";
+import { registerProvideSurface, type ProvideSurfaceRegistration } from "./extension-provide-surface.js";
 import type { ExtensionHandler, ExtensionOptions, ExtensionToolHandler, ExtensionToolOptions, ReadyCallback } from "./extension-contract.js";
 export declare class Extension {
     readonly definition: ExtensionDefinition;
@@ -15,6 +16,7 @@ export declare class Extension {
     private readonly watchSources;
     private readonly readyCallbacks;
     private readonly transportBindings;
+    private readonly provideSurfaces;
     private readonly host;
     private initialized;
     private shutdownStarted;
@@ -26,9 +28,11 @@ export declare class Extension {
     constructor(definition: ExtensionDefinition, options?: ExtensionOptions);
     bindTransport(transport: TransportLike): this;
     handle<TParams = unknown, TResult = unknown>(method: string, handler: ExtensionHandler<TParams, TResult>): this;
+    [registerProvideSurface](capability: string, registrations: readonly ProvideSurfaceRegistration[]): this;
     tool<TInput = unknown>(handler: string, options: ExtensionToolOptions, toolHandler: ExtensionToolHandler<TInput>): this;
     watchSource<TSpec extends JSONValue = JSONValue>(kind: string, options: ExtensionWatchSourceOptions, handler: ExtensionWatchSourceHandler<TSpec>): this;
     commandGroup(path: string, summary: string): this;
+    private ensureRegistrationOpen;
     onReady(callback: ReadyCallback): this;
     start(): Promise<HostAPI>;
     getImplementedMethods(): string[];

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

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

package/dist/types/generated/contracts.d.ts

@@ -734,6 +734,18 @@ export interface AutomationTriggersParams {
     cursor?: string;
     limit?: number;
 }
+export interface GatewayIngressPayload {
+    subject_kind: string;
+    subject_id: string;
+    scope_kind: string;
+    workspace_id?: string;
+    url?: string;
+    reachability: string;
+    endpoint_generation: number;
+    confirmed_endpoint_generation?: number;
+    confirmed_at?: ISODateTime;
+    enable_path?: string;
+}
 export interface Trigger {
     id: string;
     scope: Scope;
@@ -753,6 +765,7 @@ export interface Trigger {
     endpoint_slug?: string;
     webhook_secret_present: boolean;
     webhook_secret_hash?: string;
+    ingress?: GatewayIngressPayload;
     created_at: ISODateTime;
     updated_at: ISODateTime;
 }
@@ -844,6 +857,7 @@ export interface BridgeTargetSnapshotResponse {
 }
 export interface BridgeWebhookRegistrationRequest {
     bridge_instance_id: string;
+    public_url?: string;
 }
 export interface BridgeWebhookRegistrationResponse {
     status: BridgeCheckStatus;
@@ -895,6 +909,34 @@ export interface CompactionMatcher {
     compaction_reason?: string;
     compaction_strategy?: string;
 }
+export interface ConnectivityAdvertisedEndpoint {
+    url: string;
+    scheme: string;
+    scheme_policy?: string;
+    stability: string;
+}
+export interface ConnectivityEstablishRequest {
+    tier: string;
+    forward_target: string;
+    challenge_path: string;
+    deadline: ISODateTime;
+}
+export interface ConnectivityReachability {
+    tier: string;
+    endpoints: ConnectivityAdvertisedEndpoint[];
+    health: string;
+    reason?: string;
+}
+export interface ConnectivityStatusRequest {
+    tier: string;
+}
+export interface ConnectivityTeardownRequest {
+    tier: string;
+    deadline: ISODateTime;
+}
+export interface ConnectivityTeardownResponse {
+    stopped: boolean;
+}
 export interface ConsentArea {
     area: string;
     access: string;
@@ -1224,6 +1266,11 @@ export interface DeliveryRequest {
     event: DeliveryEvent;
     snapshot?: DeliverySnapshot;
 }
+export interface DescribeNetworkParticipation {
+    required: boolean;
+    mode: string;
+    channel_scopes?: string[];
+}
 export interface DescribeResources {
     skills?: string[];
     loops?: string[];
@@ -1279,6 +1326,7 @@ export interface DescribePayload {
     requires_env?: string[];
     resources: DescribeResources;
     subprocess: DescribeSubprocess;
+    network_participation?: DescribeNetworkParticipation;
     tools?: ExtensionToolRuntimeDescriptor[];
     hook_events?: string[];
     watch_source_kinds?: string[];
@@ -6270,6 +6318,7 @@ export interface HostAPIMethodMap {
 }
 export declare const REQUIRED_METHODS_BY_PROVIDE: {
     readonly "bridge.adapter": readonly ["bridges/deliver", "bridges/targets/snapshot"];
+    readonly "connectivity.provider": readonly ["connectivity/establish", "connectivity/status", "connectivity/teardown"];
     readonly "loop.watch_source": readonly ["watch/poll"];
     readonly "memory.backend": readonly ["memory/forget", "memory/recall", "memory/store"];
     readonly "model.source": readonly ["models/list"];