@moorline/contracts 0.0.1 → 0.0.2

package/dist/plugin-runtime.d.ts

@@ -1,14 +1,15 @@
 import type { Capability } from './capabilities.js';
+import type { JsonSchemaLike } from './package.js';
 import type { PluginManifest, RuntimeManagementContribution } from './plugin.js';
 import type { RuntimeProviderTestResult } from './provider.js';
 import type { RuntimeActionDefinition, RuntimeActorIdentity, RuntimeAttachmentPayload, RuntimeMessagePayload, RuntimeSurfaceState, RuntimeTransportEvent } from './transport.js';
-import type { PendingRuntimeRequestRecord, ProviderRuntimeEvent, ProviderSessionStatus, ProviderThreadTokenUsage, RuntimeModeName } from './runtime.js';
+import type { PendingRuntimeRequestRecord, ProviderResumeCursor, ProviderRuntimeEvent, ProviderSessionStatus, ProviderThreadTokenUsage, RuntimeAgentKind, RuntimeModeName } from './runtime.js';
+import type { RuntimeExternalResourceRecord, RuntimeExternalResourceRef, RuntimeGateRunRecord, RuntimeHeadlessRunResult, RuntimeWorkItemRecord, RuntimeWorkItemStatus } from './external.js';
 export interface RuntimeDomainEvent {
     eventId: string;
     threadId: string;
-    spaceId?: string | null;
+    transportResourceId?: string | null;
     sessionId?: string | null;
-    missionId?: string | null;
     sourceProviderEventId?: string | null;
     createdAt: string;
     type: string;
@@ -42,10 +43,8 @@ export interface WrittenSkillResult {
 export type RuntimeEntityRecord = {
     id?: string;
     sessionId?: string;
-    missionId?: string;
-    runId?: string;
     threadId?: string;
-    spaceId?: string;
+    transportResourceId?: string;
     name?: string;
     title?: string;
     status?: string;
@@ -57,13 +56,16 @@ export type RuntimeSessionRow = RuntimeEntityRecord & {
     sessionId: string;
     scopeId: string;
     threadId: string;
-    spaceId: string;
-    spaceName: string;
-    workspacePath: string;
+    transportResourceId: string;
+    transportResourceName: string;
+    agentKind?: RuntimeAgentKind;
+    workspacePath: string | null;
+    providerCwd?: string | null;
     summary: string | null;
     provider: string;
     providerThreadId: string | null;
-    resumeThreadId: string | null;
+    resumeCursor?: ProviderResumeCursor | null;
+    toolGrantIds?: string[];
     providerStatus: ProviderSessionStatus;
     activeTurnId: string | null;
     createdAt: string;
@@ -74,24 +76,10 @@ export type RuntimeSessionRow = RuntimeEntityRecord & {
     lifecycleStatus: SessionLifecycleStatus;
     runtimeMode: RuntimeModeName;
 };
-export type RuntimeMissionRow = RuntimeEntityRecord & {
-    missionId: string;
-    title: string;
-    spaceId: string;
-};
-export type RuntimeMissionRunRow = RuntimeEntityRecord & {
-    runId: string;
-    missionId: string;
-};
-export type RuntimeMissionHookBindingRow = RuntimeEntityRecord & {
-    bindingId: string;
-    missionId: string;
-    hookKey: string;
-};
 export interface RuntimeReceiptRecord {
     threadId: string;
     sessionId: string | null;
-    spaceId: string | null;
+    transportResourceId: string | null;
     state: string;
     updatedAt: string;
 }
@@ -105,7 +93,9 @@ export interface RuntimeProviderConnectionSnapshot {
     threadId: string;
     providerPackageId: string;
     runtimeMode: RuntimeModeName;
-    workspacePath: string;
+    agentKind?: RuntimeAgentKind;
+    workspacePath: string | null;
+    providerCwd?: string | null;
     providerThreadId: string | null;
     status: ProviderSessionStatus;
     model: string | null;
@@ -205,10 +195,10 @@ export interface ManagedSidecarRecord {
     scopeKey: string;
     status: string;
 }
-export type AgentSurface = 'main_chat' | 'session' | 'mission';
+export type AgentSurface = 'coordination' | 'session';
 export interface BeforeAgentPromptInput {
     surface: AgentSurface;
-    spaceId: string;
+    transportResourceId: string;
     actorId: string;
     actorLabel: string;
     text: string;
@@ -218,31 +208,46 @@ export interface BeforeAgentPromptInput {
 export interface AfterAgentResponseInput extends BeforeAgentPromptInput {
     replyMessage: string;
 }
+export interface RuntimeAgentContextContribution {
+    systemPromptSections?: string[];
+    perTurnContext?: Array<{
+        title: string;
+        content: string;
+        source: string;
+    }>;
+    toolGrantIds?: string[];
+}
 export interface CreatedSessionResult {
     session: RuntimeSessionRow;
-    spaceId: string;
+    transportResourceId: string;
 }
-export type MissionHookCondition = Record<string, string | number | boolean | null>;
-export interface MissionHookDispatchResult {
-    hookKey: string;
-    source: string;
-    bindingCount: number;
-    matchedBindingCount: number;
-    triggeredMissionIds: string[];
-}
-export type ArchivedSpaceTarget = {
+export type ArchivedTransportResourceTarget = {
     kind: 'session';
     session: RuntimeSessionRow;
-} | {
-    kind: 'mission';
-    mission: RuntimeMissionRow;
 };
-export type SessionOwnerKind = 'mission' | 'run' | 'parent_session' | 'orchestrator';
+export type SessionOwnerKind = string;
 export interface SessionOwnerLink {
     kind: SessionOwnerKind;
     id: string;
     label?: string;
 }
+export interface RuntimePackageStateRecord<T = unknown> {
+    packageId: string;
+    key: string;
+    value: T | null;
+    updatedAt: string;
+}
+export interface RuntimePackageJobRecord {
+    packageId: string;
+    jobId: string;
+    actionId: string;
+    schedule: string;
+    scheduleAnchorAt: string;
+    nextRunAt: string | null;
+    payload: Record<string, unknown>;
+    createdAt: string;
+    updatedAt: string;
+}
 export interface SessionQueryFilter {
     scope?: SessionInventoryScope;
     lifecycleStatuses?: RuntimeSessionRow['lifecycleStatus'][];
@@ -275,14 +280,15 @@ export interface RuntimePluginAdminConfig {
     };
 }
 export type RuntimePluginConfig = object;
-export type RuntimePluginNamespaceState = RuntimeSurfaceState;
+export type RuntimePluginSurfaceState = RuntimeSurfaceState;
 export interface RuntimeToolContext {
     readonly actorId: string;
     readonly config: RuntimePluginConfig;
-    getCurrentSpaceId(): string;
+    getCurrentTransportResourceId(): string;
     getCurrentThreadId(): string;
     getCurrentWorkspacePath(): string;
-    getChatWorkspacePath(): string;
+    getCoordinationWorkspacePath(): string;
+    getRuntimeRootPath(): string;
     listSkills(): SkillCatalogEntry[];
     loadSkill(name: string): Promise<LoadedSkill | null>;
     writeSkill(input: {
@@ -297,29 +303,100 @@ export interface RuntimeToolContext {
         }>;
     }): Promise<WrittenSkillResult>;
     listSessions(): RuntimeSessionRow[];
-    getSessionBySpaceId(spaceId: string): RuntimeSessionRow | null;
+    getSessionByTransportResourceId(transportResourceId: string): RuntimeSessionRow | null;
     getSessionById(sessionId: string): RuntimeSessionRow | null;
-    listMissions(): RuntimeMissionRow[];
-    getMissionBySpaceId(spaceId: string): RuntimeMissionRow | null;
-    getMissionById(missionId: string): RuntimeMissionRow | null;
-    listMissionRuns(missionId: string, limit?: number): RuntimeMissionRunRow[];
-    listMissionHookBindings(filter?: {
-        missionId?: string;
-        hookKey?: string;
-    }): RuntimeMissionHookBindingRow[];
-    bindMissionHook(input: {
-        missionId: string;
-        hookKey: string;
-        condition?: MissionHookCondition;
-    }): Promise<RuntimeMissionHookBindingRow>;
-    unbindMissionHook(input: {
-        bindingId: string;
-    }): Promise<RuntimeMissionHookBindingRow | null>;
-    emitMissionHook(input: {
-        hookKey: string;
+    getPackageState<T = unknown>(key: string): T | null;
+    putPackageState<T = unknown>(key: string, value: T): Promise<void>;
+    deletePackageState(key: string): Promise<void>;
+    listPackageState<T = unknown>(prefix?: string): RuntimePackageStateRecord<T>[];
+    schedulePackageJob(input: {
+        jobId: string;
+        actionId: string;
+        schedule: string;
+        startTime?: string;
+        payload?: Record<string, unknown>;
+    }): Promise<RuntimePackageJobRecord>;
+    cancelPackageJob(jobId: string): Promise<RuntimePackageJobRecord | null>;
+    listPackageJobs(): RuntimePackageJobRecord[];
+    enqueueWorkItem(input: {
+        queue: string;
+        workItemId?: string;
+        idempotencyKey?: string;
+        externalResource?: RuntimeExternalResourceRef;
         payload?: Record<string, unknown>;
-        source?: string;
-    }): Promise<MissionHookDispatchResult>;
+        priority?: number;
+        runAfter?: string | null;
+        maxAttempts?: number;
+    }): Promise<RuntimeWorkItemRecord>;
+    claimWorkItem(input: {
+        queue: string;
+        leaseSeconds?: number;
+        leaseOwner?: string;
+    }): Promise<RuntimeWorkItemRecord | null>;
+    completeWorkItem(input: {
+        workItemId: string;
+        phase?: string;
+    }): Promise<RuntimeWorkItemRecord>;
+    failWorkItem(input: {
+        workItemId: string;
+        error: string;
+        retryAfter?: string | null;
+        phase?: string;
+    }): Promise<RuntimeWorkItemRecord>;
+    deadLetterWorkItem(input: {
+        workItemId: string;
+        reason: string;
+        phase?: string;
+    }): Promise<RuntimeWorkItemRecord>;
+    updateWorkItem(input: {
+        workItemId: string;
+        payload?: Record<string, unknown>;
+        phase?: string;
+        externalResource?: RuntimeExternalResourceRef;
+        sessionId?: string;
+    }): Promise<RuntimeWorkItemRecord>;
+    getWorkItem(workItemId: string): RuntimeWorkItemRecord | null;
+    listWorkItems(filter?: {
+        queue?: string;
+        status?: RuntimeWorkItemStatus;
+        externalResource?: RuntimeExternalResourceRef;
+        limit?: number;
+    }): RuntimeWorkItemRecord[];
+    upsertExternalResource(input: RuntimeExternalResourceRef & {
+        state?: string;
+    }): Promise<RuntimeExternalResourceRecord>;
+    listExternalResources(filter?: {
+        provider?: string;
+        kind?: string;
+        limit?: number;
+    }): RuntimeExternalResourceRecord[];
+    bindSessionToExternalResource(input: {
+        sessionId: string;
+        externalResource: RuntimeExternalResourceRef;
+        relationship?: string;
+    }): Promise<void>;
+    listSessionsForExternalResource(resource: RuntimeExternalResourceRef): RuntimeSessionSnapshot[];
+    runGate(input: {
+        gateId: string;
+        command: string;
+        args?: string[];
+        cwd?: string;
+        required?: boolean;
+        workItemId?: string;
+        sessionId?: string;
+    }): Promise<RuntimeGateRunRecord>;
+    runHeadless(input: {
+        requestedName: string;
+        runtimeMode: RuntimeModeName;
+        prompt: string;
+        objective?: string;
+        owner?: SessionOwnerLink;
+        tags?: string[];
+        externalResource?: RuntimeExternalResourceRef;
+        workItemId?: string;
+        outputSchema?: JsonSchemaLike;
+        requireStructuredOutput?: boolean;
+    }): Promise<RuntimeHeadlessRunResult>;
     querySessions(filter?: SessionQueryFilter): RuntimeSessionSnapshot[];
     createSession(input: {
         requestedName: string;
@@ -328,10 +405,12 @@ export interface RuntimeToolContext {
         objective?: string;
         owner?: SessionOwnerLink;
         tags?: string[];
+        externalResource?: RuntimeExternalResourceRef;
+        workItemId?: string;
     }): Promise<CreatedSessionResult>;
     directSession(input: {
         sessionId?: string;
-        spaceId?: string;
+        transportResourceId?: string;
         instruction: string;
         reason?: string;
     }): Promise<{
@@ -339,41 +418,14 @@ export interface RuntimeToolContext {
         reply: RuntimeMessagePayload;
     }>;
     archiveSession(input: {
-        spaceId: string;
+        transportResourceId: string;
         sessionId?: string;
     }): Promise<RuntimeSessionRow | null>;
     deleteArchivedSession(input: {
-        spaceId: string;
+        transportResourceId: string;
         sessionId?: string;
     }): Promise<RuntimeSessionRow | null>;
-    createMission(input: {
-        title: string;
-        goal: string;
-        schedule: string;
-        startTime?: string;
-        runtimeMode: RuntimeModeName;
-    }): Promise<{
-        mission: RuntimeMissionRow;
-        spaceId: string;
-    }>;
-    pauseMission(input: {
-        spaceId: string;
-        missionId?: string;
-    }): Promise<RuntimeMissionRow | null>;
-    resumeMission(input: {
-        spaceId: string;
-        missionId?: string;
-    }): Promise<RuntimeMissionRow | null>;
-    stopMission(input: {
-        spaceId: string;
-        missionId?: string;
-    }): Promise<RuntimeMissionRow | null>;
-    runMissionNow(input: {
-        spaceId: string;
-        missionId?: string;
-        requesterActorId?: string;
-    }): Promise<RuntimeMissionRow | null>;
-    sendMessage(spaceId: string, payload: RuntimeMessagePayload): Promise<void>;
+    sendMessage(transportResourceId: string, payload: RuntimeMessagePayload): Promise<void>;
     sendStatusUpdate(payload: RuntimeMessagePayload): Promise<void>;
     appendAuditEvent(event: string, payload: Record<string, unknown>): void;
     nowIso(): string;
@@ -381,14 +433,14 @@ export interface RuntimeToolContext {
 export interface RuntimePluginAdminCapability {
     getAdminConfig(): RuntimePluginAdminConfig;
     isAdminActor(input: RuntimeActorIdentity): boolean;
-    getNamespaceState(): RuntimePluginNamespaceState;
+    getSurfaceState(): RuntimePluginSurfaceState;
 }
 export interface RuntimePluginObservabilityCapability {
-    listPendingRequests(spaceId: string): PendingRuntimeRequestRecord[];
+    listPendingRequests(transportResourceId: string): PendingRuntimeRequestRecord[];
     listRuntimeReceipts(): RuntimeReceiptRecord[];
     listProviderConnections(): RuntimeProviderConnectionSnapshot[];
     listRuntimeActivities(threadId?: string): RuntimeActivityRecord[];
-    getSessionSnapshotBySpaceId(spaceId: string): RuntimeSessionSnapshot | null;
+    getSessionSnapshotByTransportResourceId(transportResourceId: string): RuntimeSessionSnapshot | null;
     getSessionSnapshotById(sessionId: string): RuntimeSessionSnapshot | null;
     getRuntimeOverview(): RuntimeOverviewSnapshot;
     listProjectionStates(): Array<{
@@ -416,20 +468,20 @@ export interface RuntimePluginObservabilityCapability {
     };
     listRuntimeEvents(threadId: string): ProviderRuntimeEvent[];
     listDomainEvents(threadId: string): RuntimeDomainEvent[];
-    updateSessionSummary(spaceId: string, summary: string, nowIso: string): Promise<void>;
+    updateSessionSummary(transportResourceId: string, summary: string, nowIso: string): Promise<void>;
 }
 export interface RuntimePluginMemoryCapability {
     retrieveMemory(input: {
         query: string;
         scopeId: string;
-        spaceId?: string;
+        transportResourceId?: string;
         threadId?: string | null;
         maxResults?: number;
         enableRerank?: boolean;
     }): Promise<RetrievedMemorySnippet[]>;
     writeSessionMemory(input: {
         scopeId: string;
-        spaceId: string;
+        transportResourceId: string;
         threadId?: string | null;
         kind: 'log' | 'summary' | 'facts' | 'tasks';
         content: string;
@@ -449,20 +501,12 @@ export interface RuntimePluginMemoryCapability {
     }): Promise<void>;
 }
 export interface RuntimePluginWorkManagementCapability {
-    archiveMission(input: {
-        spaceId: string;
-        missionId?: string;
-    }): Promise<RuntimeMissionRow | null>;
-    deleteArchivedMission(input: {
-        spaceId: string;
-        missionId?: string;
-    }): Promise<RuntimeMissionRow | null>;
-    archiveSpaceTarget(input: {
-        spaceId: string;
-    }): Promise<ArchivedSpaceTarget | null>;
-    deleteArchivedSpaceTarget(input: {
-        spaceId: string;
-    }): Promise<ArchivedSpaceTarget | null>;
+    archiveTransportResourceTarget(input: {
+        transportResourceId: string;
+    }): Promise<ArchivedTransportResourceTarget | null>;
+    deleteArchivedTransportResourceTarget(input: {
+        transportResourceId: string;
+    }): Promise<ArchivedTransportResourceTarget | null>;
     respondToRuntimeRequest(input: {
         threadId: string;
         requestId: string;
@@ -531,15 +575,24 @@ export interface RuntimePluginSidecarCapability {
 export interface RuntimePluginAgentCapability {
     runAgent(input: {
         surface: AgentSurface;
-        spaceId: string;
+        transportResourceId: string;
         actorId: string;
         actorLabel: string;
-        text: string;
+        message: string;
         attachments?: RuntimeAttachmentPayload[];
         session: RuntimeSessionRow | null;
-        cwd: string;
+        cwd?: string | null;
         runtimeMode: RuntimeModeName;
-        basePromptSections: string[];
+        agentKind?: RuntimeAgentKind;
+        toolGrantIds?: string[];
+        context?: {
+            systemPromptSections?: string[];
+            perTurnContext?: Array<{
+                title: string;
+                content: string;
+                source: string;
+            }>;
+        };
         promptSource?: string;
     }): Promise<RuntimeMessagePayload>;
     drainRuntimeWork(): Promise<void>;
@@ -561,11 +614,14 @@ export interface RuntimePlugin {
     tools?(context: RuntimeToolContext): RuntimeToolDefinition[];
     onRuntimeStarted?(context: RuntimePluginContext): Promise<void> | void;
     onTransportEvent?(event: RuntimeTransportEvent, context: RuntimePluginContext): Promise<RuntimeActionDispatchResult | boolean | void> | RuntimeActionDispatchResult | boolean | void;
+    onExternalEvent?(event: Extract<RuntimeTransportEvent, {
+        type: 'external.event.received';
+    }>, context: RuntimePluginContext): Promise<RuntimeActionDispatchResult | boolean | void> | RuntimeActionDispatchResult | boolean | void;
     onAction?(event: Extract<RuntimeTransportEvent, {
         type: 'action.invoked';
     }>, context: RuntimePluginContext): Promise<RuntimeActionDispatchResult | boolean | void> | RuntimeActionDispatchResult | boolean | void;
     onRuntimeEvent?(event: ProviderRuntimeEvent, context: RuntimePluginContext): Promise<void> | void;
-    beforeAgentPrompt?(input: BeforeAgentPromptInput, context: RuntimePluginContext): Promise<string[]> | string[];
+    contributeAgentContext?(input: BeforeAgentPromptInput, context: RuntimePluginContext): Promise<RuntimeAgentContextContribution> | RuntimeAgentContextContribution;
     afterAgentResponse?(input: AfterAgentResponseInput, context: RuntimePluginContext): Promise<void> | void;
     onDomainEvent?(event: RuntimeDomainEvent, context: RuntimePluginContext): Promise<void> | void;
     onRuntimeReceipt?(receipt: RuntimeReceiptRecord, context: RuntimePluginContext): Promise<void> | void;

package/dist/plugin.d.ts

@@ -26,5 +26,5 @@ export interface RuntimeManagementContribution {
 }
 export type { RuntimeActionDefinition };
 export * from './plugin-runtime.js';
-export declare const KNOWN_PLUGIN_HOOKS: readonly ["onRuntimeStarted", "onTransportEvent", "onAction", "onRuntimeEvent", "beforeAgentPrompt", "afterAgentResponse", "onDomainEvent", "onRuntimeReceipt", "onRuntimeActivity"];
+export declare const KNOWN_PLUGIN_HOOKS: readonly ["onRuntimeStarted", "onTransportEvent", "onExternalEvent", "onAction", "onRuntimeEvent", "contributeAgentContext", "afterAgentResponse", "onDomainEvent", "onRuntimeReceipt", "onRuntimeActivity"];
 export declare function validatePluginManifest(manifest: PluginManifest): PluginManifest;

package/dist/plugin.js

@@ -4,9 +4,10 @@ export * from './plugin-runtime.js';
 export const KNOWN_PLUGIN_HOOKS = [
     'onRuntimeStarted',
     'onTransportEvent',
+    'onExternalEvent',
     'onAction',
     'onRuntimeEvent',
-    'beforeAgentPrompt',
+    'contributeAgentContext',
     'afterAgentResponse',
     'onDomainEvent',
     'onRuntimeReceipt',

package/dist/plugin.js.map

@@ -1 +1 @@
-{"version":3,"file":"plugin.js","sourceRoot":"","sources":["../src/plugin.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,sBAAsB,EAAE,6BAA6B,EAAE,2BAA2B,EAAE,iBAAiB,EAAE,MAAM,cAAc,CAAC;AACrI,OAAO,EAAE,YAAY,EAAE,qBAAqB,EAAmB,MAAM,mBAAmB,CAAC;AA8BzF,cAAc,qBAAqB,CAAC;AAEpC,MAAM,CAAC,MAAM,kBAAkB,GAAG;IAChC,kBAAkB;IAClB,kBAAkB;IAClB,UAAU;IACV,gBAAgB;IAChB,mBAAmB;IACnB,oBAAoB;IACpB,eAAe;IACf,kBAAkB;IAClB,mBAAmB;CACX,CAAC;AAEX,MAAM,qBAAqB,GAAG,IAAI,GAAG,CAAS,kBAAkB,CAAC,CAAC;AAClE,MAAM,UAAU,sBAAsB,CAAC,QAAwB;IAC7D,IAAI,CAAC,QAAQ,IAAI,OAAO,QAAQ,KAAK,QAAQ,IAAI,KAAK,CAAC,OAAO,CAAC,QAAQ,CAAC,EAAE,CAAC;QACzE,MAAM,IAAI,KAAK,CAAC,mCAAmC,CAAC,CAAC;IACvD,CAAC;IACD,MAAM,MAAM,GAAG,QAA8C,CAAC;IAC9D,iBAAiB,CAAC,MAAM,CAAC,EAAE,EAAE,oBAAoB,CAAC,CAAC;IACnD,IAAI,OAAO,MAAM,CAAC,IAAI,KAAK,QAAQ,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,EAAE,EAAE,CAAC;QAC3D,MAAM,IAAI,KAAK,CAAC,kCAAkC,CAAC,CAAC;IACtD,CAAC;IACD,IAAI,OAAO,MAAM,CAAC,OAAO,KAAK,QAAQ,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC,IAAI,EAAE,EAAE,CAAC;QACjE,MAAM,IAAI,KAAK,CAAC,qCAAqC,CAAC,CAAC;IACzD,CAAC;IACD,IAAI,MAAM,CAAC,IAAI,KAAK,QAAQ,EAAE,CAAC;QAC7B,MAAM,IAAI,KAAK,CAAC,uCAAuC,CAAC,CAAC;IAC3D,CAAC;IACD,IAAI,MAAM,CAAC,WAAW,KAAK,SAAS,IAAI,CAAC,OAAO,MAAM,CAAC,WAAW,KAAK,QAAQ,IAAI,CAAC,MAAM,CAAC,WAAW,CAAC,IAAI,EAAE,CAAC,EAAE,CAAC;QAC/G,MAAM,IAAI,KAAK,CAAC,6DAA6D,CAAC,CAAC;IACjF,CAAC;IACD,IAAI,MAAM,CAAC,UAAU,KAAK,SAAS,IAAI,CAAC,OAAO,MAAM,CAAC,UAAU,KAAK,QAAQ,IAAI,CAAC,MAAM,CAAC,UAAU,CAAC,IAAI,EAAE,CAAC,EAAE,CAAC;QAC5G,MAAM,IAAI,KAAK,CAAC,4DAA4D,CAAC,CAAC;IAChF,CAAC;IACD,IAAI,MAAM,CAAC,QAAQ,KAAK,SAAS,IAAI,CAAC,CAAC,MAAM,CAAC,SAAS,CAAC,MAAM,CAAC,QAAQ,CAAC,IAAK,MAAM,CAAC,QAAmB,GAAG,CAAC,CAAC,EAAE,CAAC;QAC7G,MAAM,IAAI,KAAK,CAAC,uEAAuE,CAAC,CAAC;IAC3F,CAAC;IACD,IAAI,MAAM,CAAC,cAAc,KAAK,SAAS,IAAI,OAAO,MAAM,CAAC,cAAc,KAAK,SAAS,EAAE,CAAC;QACtF,MAAM,IAAI,KAAK,CAAC,gEAAgE,CAAC,CAAC;IACpF,CAAC;IACD,IACE,MAAM,CAAC,eAAe,KAAK,SAAS;QACpC,CAAC,OAAO,MAAM,CAAC,eAAe,KAAK,QAAQ,IAAI,CAAC,MAAM,CAAC,eAAe,CAAC,IAAI,EAAE,CAAC,EAC9E,CAAC;QACD,MAAM,IAAI,KAAK,CAAC,0EAA0E,CAAC,CAAC;IAC9F,CAAC;IACD,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,YAAY,CAAC,IAAI,MAAM,CAAC,YAAY,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC5E,MAAM,IAAI,KAAK,CAAC,mEAAmE,CAAC,CAAC;IACvF,CAAC;IACD,2BAA2B,CAAC,MAAM,CAAC,YAAY,EAAE,iBAAiB,CAAC,CAAC;IACpE,sBAAsB,CAAC,MAAM,CAAC,YAAY,EAAE,iBAAiB,CAAC,CAAC;IAC/D,MAAM,UAAU,GAAG,6BAA6B,CAAC,MAAM,CAAC,UAAU,EAAE,iBAAiB,CAAC,CAAC;IACvF,KAAK,MAAM,UAAU,IAAI,MAAM,CAAC,YAAY,EAAE,CAAC;QAC7C,IAAI,CAAC,YAAY,CAAC,UAAU,CAAC,EAAE,CAAC;YAC9B,MAAM,IAAI,KAAK,CAAC,uBAAuB,UAAU,EAAE,CAAC,CAAC;QACvD,CAAC;QACD,IAAI,CAAC,qBAAqB,CAAC,MAAM,CAAC,EAAY,EAAE,UAAU,CAAC,EAAE,CAAC;YAC5D,MAAM,IAAI,KAAK,CAAC,4BAA4B,UAAU,2BAA2B,MAAM,CAAC,EAAY,EAAE,CAAC,CAAC;QAC1G,CAAC;IACH,CAAC;IACD,IAAI,MAAM,CAAC,KAAK,KAAK,SAAS,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC;QAC/D,MAAM,IAAI,KAAK,CAAC,sDAAsD,CAAC,CAAC;IAC1E,CAAC;IACD,KAAK,MAAM,IAAI,IAAK,MAAM,CAAC,KAA+B,IAAI,EAAE,EAAE,CAAC;QACjE,IAAI,OAAO,IAAI,KAAK,QAAQ,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,EAAE,CAAC;YAC7C,MAAM,IAAI,KAAK,CAAC,yCAAyC,CAAC,CAAC;QAC7D,CAAC;QACD,IAAI,CAAC,qBAAqB,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC;YACrC,MAAM,IAAI,KAAK,CAAC,wBAAwB,IAAI,EAAE,CAAC,CAAC;QAClD,CAAC;IACH,CAAC;IACD,OAAO;QACL,GAAG,QAAQ;QACX,GAAG,CAAC,UAAU,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,UAAU,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;KACpD,CAAC;AACJ,CAAC"}
+{"version":3,"file":"plugin.js","sourceRoot":"","sources":["../src/plugin.ts"],"names":[],"mappings":"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"}

package/dist/provider.d.ts

@@ -1,12 +1,16 @@
 import type { JsonSchemaLike, PackageDependency, PackageManifestBase } from './package.js';
 import type { EventEmitter } from 'node:events';
-import type { ProviderPackageId, ProviderInputImage, ProviderRuntimeEvent, ProviderSessionRecord, RuntimeCommandRunner, RuntimeModeName } from './runtime.js';
+import type { ProviderPackageId, ProviderInputImage, ProviderResumeCursor, ProviderRuntimeEvent, ProviderSessionRecord, RuntimeCommandRunner, RuntimeAgentKind, RuntimeModeName } from './runtime.js';
+import type { Capability } from './capabilities.js';
+import type { RuntimeToolResult } from './plugin-runtime.js';
 export interface ProviderPackageManifest extends PackageManifestBase {
     type: 'provider';
     entrypoint?: string;
     dependencies?: PackageDependency[];
     configSchema?: JsonSchemaLike;
     displayCategory?: string;
+    toolPolicy?: ProviderToolPolicyConfig;
+    nativeToolDocumentation?: ProviderNativeToolDocumentation;
 }
 export interface RuntimeProviderPackageContext {
     config: Record<string, unknown>;
@@ -31,12 +35,84 @@ export interface RuntimeProviderTestResult {
 export interface RuntimeProviderSessionInput {
     sessionId: string;
     threadId: string;
-    spaceId: string;
+    transportResourceId: string;
     runtimeMode: RuntimeModeName;
-    workspacePath: string;
-    resumeThreadId: string | null;
+    agentKind: RuntimeAgentKind;
+    workspacePath: string | null;
+    providerCwd: string | null;
+    resumeCursor: ProviderResumeCursor | null;
     lifecycleStatus: string;
     providerAutoStartEnabled?: boolean;
+    toolGrantIds: string[];
+    toolPolicy: ProviderToolPolicyConfig;
+}
+export interface ProviderToolPolicyProfileConfig {
+    nativePreset: string;
+    allowNativeTools?: string[];
+    denyNativeTools?: string[];
+    grants?: string[];
+}
+export interface ProviderToolPolicyConfig {
+    workspace: ProviderToolPolicyProfileConfig;
+    ephemeral: ProviderToolPolicyProfileConfig;
+}
+export interface ProviderNativeToolDocumentation {
+    nativeToolNames: string[];
+    defaultWorkspacePreset: string;
+    defaultEphemeralPreset: string;
+    grantMapping: string;
+}
+export declare const DEFAULT_PROVIDER_TOOL_POLICY: ProviderToolPolicyConfig;
+export interface ProviderSkillResource {
+    name: string;
+    description: string;
+    filePath: string;
+    baseDir: string;
+    content?: string;
+    metadata: Record<string, unknown>;
+}
+export interface ProviderPromptTemplateResource {
+    name: string;
+    description?: string;
+    content: string;
+    source: string;
+}
+export interface ProviderResourceBundle {
+    systemPromptSections: string[];
+    contextFiles: Array<{
+        path: string;
+        content: string;
+        source: string;
+    }>;
+    skills: ProviderSkillResource[];
+    promptTemplates: ProviderPromptTemplateResource[];
+}
+export interface ProviderToolDefinition {
+    id: string;
+    name: string;
+    description: string;
+    inputSchema: Record<string, unknown>;
+    requiredCapability?: Capability;
+    source: 'core' | 'plugin';
+    ownerPackageId?: string;
+}
+export interface ProviderToolExecutor {
+    executeProviderTool(input: {
+        threadId: string;
+        toolId: string;
+        arguments: Record<string, unknown>;
+        actor: string;
+    }): Promise<RuntimeToolResult>;
+}
+export interface ProviderTurnContextItem {
+    title: string;
+    content: string;
+    source: string;
+}
+export interface ProviderTurnInput {
+    text: string;
+    images?: ProviderInputImage[];
+    context?: ProviderTurnContextItem[];
 }
 export interface RuntimeProvider extends EventEmitter<{
     providerEvent: [event: ProviderRuntimeEvent];
@@ -48,6 +124,9 @@ export interface RuntimeProvider extends EventEmitter<{
         runtimeRoot: string;
         actor: string;
         model?: string;
+        resources?: ProviderResourceBundle;
+        tools?: ProviderToolDefinition[];
+        toolExecutor?: ProviderToolExecutor;
     }): Promise<ProviderSessionRecord>;
     recoverSessions(input: {
         sessions: RuntimeProviderSessionInput[];
@@ -61,10 +140,7 @@ export interface RuntimeProvider extends EventEmitter<{
         sendTurn?: boolean;
         prompt?: string;
     }): Promise<RuntimeProviderTestResult>;
-    sendTurn(threadId: string, input: {
-        text: string;
-        images?: ProviderInputImage[];
-    }, model?: string): Promise<{
+    sendTurn(threadId: string, input: ProviderTurnInput, model?: string): Promise<{
         turnId: string;
     }>;
     compactThread(threadId: string): Promise<void>;
@@ -86,4 +162,9 @@ export interface RuntimeProviderPackage {
     createEnvironmentVerifier?(input: RuntimeProviderPackageContext): RuntimeEnvironmentVerifier | null;
 }
 export declare function validateProviderPackageManifest(manifest: ProviderPackageManifest): ProviderPackageManifest;
+export declare function validateProviderToolPolicyConfig(value: unknown, label?: string): ProviderToolPolicyConfig | undefined;
+export declare function validateProviderResumeCursor(value: unknown, label?: string): ProviderResumeCursor | null;
+export declare function validateRuntimeProviderSessionInput(value: unknown, label?: string): RuntimeProviderSessionInput;
+export declare function validateProviderResourceBundle(value: unknown, label?: string): ProviderResourceBundle;
+export declare function validateProviderToolDefinition(value: unknown, label?: string): ProviderToolDefinition;
 export declare function validateProviderPackageRuntimeContract(pkg: RuntimeProviderPackage): void;