@moorline/contracts 0.0.1 → 0.0.3

package/dist/provider.js

@@ -1,4 +1,14 @@
 import { validateJsonSchemaLike, validatePackageActivationRule, validatePackageDependencies, validatePackageId } from './package.js';
+import { parseRuntimeAgentKind, parseRuntimeModeName } from './runtime.js';
+export const DEFAULT_PROVIDER_TOOL_POLICY = {
+    workspace: {
+        nativePreset: 'provider-default'
+    },
+    ephemeral: {
+        nativePreset: 'none',
+        grants: ['core.moorline_session']
+    }
+};
 export function validateProviderPackageManifest(manifest) {
     if (!manifest || typeof manifest !== 'object' || Array.isArray(manifest)) {
         throw new Error('Provider package manifest must be an object');
@@ -26,12 +36,202 @@ export function validateProviderPackageManifest(manifest) {
     }
     validatePackageDependencies(record.dependencies, 'provider package manifest');
     validateJsonSchemaLike(record.configSchema, 'provider package manifest');
+    const toolPolicy = validateProviderToolPolicyConfig(record.toolPolicy, 'provider package manifest.toolPolicy');
+    const nativeToolDocumentation = validateProviderNativeToolDocumentation(record.nativeToolDocumentation, 'provider package manifest.nativeToolDocumentation');
     const activation = validatePackageActivationRule(record.activation, 'provider package manifest');
     return {
         ...manifest,
+        ...(toolPolicy ? { toolPolicy } : {}),
+        ...(nativeToolDocumentation ? { nativeToolDocumentation } : {}),
         ...(activation !== undefined ? { activation } : {})
     };
 }
+function validateNonEmptyString(value, label) {
+    if (typeof value !== 'string' || value.trim().length === 0) {
+        throw new Error(`${label} must be a non-empty string`);
+    }
+    return value.trim();
+}
+function validateOptionalStringArray(value, label) {
+    if (value === undefined) {
+        return undefined;
+    }
+    if (!Array.isArray(value)) {
+        throw new Error(`${label} must be an array when provided`);
+    }
+    return value.map((entry, index) => validateNonEmptyString(entry, `${label}[${index}]`));
+}
+function validateProviderToolPolicyProfileConfig(value, label) {
+    if (!value || typeof value !== 'object' || Array.isArray(value)) {
+        throw new Error(`${label} must be an object`);
+    }
+    const record = value;
+    return {
+        nativePreset: validateNonEmptyString(record.nativePreset, `${label}.nativePreset`),
+        ...(validateOptionalStringArray(record.allowNativeTools, `${label}.allowNativeTools`)
+            ? { allowNativeTools: validateOptionalStringArray(record.allowNativeTools, `${label}.allowNativeTools`) }
+            : {}),
+        ...(validateOptionalStringArray(record.denyNativeTools, `${label}.denyNativeTools`)
+            ? { denyNativeTools: validateOptionalStringArray(record.denyNativeTools, `${label}.denyNativeTools`) }
+            : {}),
+        ...(validateOptionalStringArray(record.grants, `${label}.grants`)
+            ? { grants: validateOptionalStringArray(record.grants, `${label}.grants`) }
+            : {})
+    };
+}
+export function validateProviderToolPolicyConfig(value, label = 'provider tool policy') {
+    if (value === undefined) {
+        return undefined;
+    }
+    if (!value || typeof value !== 'object' || Array.isArray(value)) {
+        throw new Error(`${label} must be an object when provided`);
+    }
+    const record = value;
+    return {
+        workspace: validateProviderToolPolicyProfileConfig(record.workspace, `${label}.workspace`),
+        ephemeral: validateProviderToolPolicyProfileConfig(record.ephemeral, `${label}.ephemeral`)
+    };
+}
+export function validateProviderResumeCursor(value, label = 'provider resume cursor') {
+    if (value === null) {
+        return null;
+    }
+    if (!value || typeof value !== 'object' || Array.isArray(value)) {
+        throw new Error(`${label} must be an object or null`);
+    }
+    const record = value;
+    return {
+        provider: validatePackageId(record.provider, `${label}.provider`),
+        value: record.value
+    };
+}
+export function validateRuntimeProviderSessionInput(value, label = 'provider session input') {
+    if (!value || typeof value !== 'object' || Array.isArray(value)) {
+        throw new Error(`${label} must be an object`);
+    }
+    const record = value;
+    const agentKind = parseRuntimeAgentKind(record.agentKind, `${label}.agentKind`);
+    const workspacePath = record.workspacePath;
+    if (workspacePath !== null && typeof workspacePath !== 'string') {
+        throw new Error(`${label}.workspacePath must be a string or null`);
+    }
+    if (agentKind === 'workspace' && !workspacePath) {
+        throw new Error(`${label}.workspacePath is required for workspace agents`);
+    }
+    if (agentKind === 'ephemeral' && workspacePath !== null) {
+        throw new Error(`${label}.workspacePath must be null for ephemeral agents`);
+    }
+    const providerCwd = record.providerCwd;
+    if (providerCwd !== null && typeof providerCwd !== 'string') {
+        throw new Error(`${label}.providerCwd must be a string or null`);
+    }
+    return {
+        sessionId: validateNonEmptyString(record.sessionId, `${label}.sessionId`),
+        threadId: validateNonEmptyString(record.threadId, `${label}.threadId`),
+        transportResourceId: validateNonEmptyString(record.transportResourceId, `${label}.transportResourceId`),
+        runtimeMode: parseRuntimeModeName(record.runtimeMode, `${label}.runtimeMode`),
+        agentKind,
+        workspacePath,
+        providerCwd,
+        resumeCursor: validateProviderResumeCursor(record.resumeCursor, `${label}.resumeCursor`),
+        lifecycleStatus: validateNonEmptyString(record.lifecycleStatus, `${label}.lifecycleStatus`),
+        ...(record.providerAutoStartEnabled !== undefined ? { providerAutoStartEnabled: record.providerAutoStartEnabled !== false } : {}),
+        toolGrantIds: validateOptionalStringArray(record.toolGrantIds, `${label}.toolGrantIds`) ?? [],
+        toolPolicy: validateProviderToolPolicyConfig(record.toolPolicy, `${label}.toolPolicy`) ?? DEFAULT_PROVIDER_TOOL_POLICY
+    };
+}
+export function validateProviderResourceBundle(value, label = 'provider resource bundle') {
+    if (!value || typeof value !== 'object' || Array.isArray(value)) {
+        throw new Error(`${label} must be an object`);
+    }
+    const record = value;
+    const contextFiles = Array.isArray(record.contextFiles) ? record.contextFiles : [];
+    const skills = Array.isArray(record.skills) ? record.skills : [];
+    const promptTemplates = Array.isArray(record.promptTemplates) ? record.promptTemplates : [];
+    return {
+        systemPromptSections: validateOptionalStringArray(record.systemPromptSections, `${label}.systemPromptSections`) ?? [],
+        contextFiles: contextFiles.map((entry, index) => {
+            if (!entry || typeof entry !== 'object' || Array.isArray(entry)) {
+                throw new Error(`${label}.contextFiles[${index}] must be an object`);
+            }
+            const file = entry;
+            return {
+                path: validateNonEmptyString(file.path, `${label}.contextFiles[${index}].path`),
+                content: typeof file.content === 'string' ? file.content : validateNonEmptyString(file.content, `${label}.contextFiles[${index}].content`),
+                source: validateNonEmptyString(file.source, `${label}.contextFiles[${index}].source`)
+            };
+        }),
+        skills: skills.map((entry, index) => validateProviderSkillResource(entry, `${label}.skills[${index}]`)),
+        promptTemplates: promptTemplates.map((entry, index) => validateProviderPromptTemplateResource(entry, `${label}.promptTemplates[${index}]`))
+    };
+}
+function validateProviderSkillResource(value, label) {
+    if (!value || typeof value !== 'object' || Array.isArray(value)) {
+        throw new Error(`${label} must be an object`);
+    }
+    const record = value;
+    const metadata = record.metadata;
+    if (!metadata || typeof metadata !== 'object' || Array.isArray(metadata)) {
+        throw new Error(`${label}.metadata must be an object`);
+    }
+    return {
+        name: validateNonEmptyString(record.name, `${label}.name`),
+        description: validateNonEmptyString(record.description, `${label}.description`),
+        filePath: validateNonEmptyString(record.filePath, `${label}.filePath`),
+        baseDir: validateNonEmptyString(record.baseDir, `${label}.baseDir`),
+        ...(record.content !== undefined ? { content: typeof record.content === 'string' ? record.content : validateNonEmptyString(record.content, `${label}.content`) } : {}),
+        metadata: metadata
+    };
+}
+function validateProviderPromptTemplateResource(value, label) {
+    if (!value || typeof value !== 'object' || Array.isArray(value)) {
+        throw new Error(`${label} must be an object`);
+    }
+    const record = value;
+    return {
+        name: validateNonEmptyString(record.name, `${label}.name`),
+        ...(record.description !== undefined ? { description: validateNonEmptyString(record.description, `${label}.description`) } : {}),
+        content: typeof record.content === 'string' ? record.content : validateNonEmptyString(record.content, `${label}.content`),
+        source: validateNonEmptyString(record.source, `${label}.source`)
+    };
+}
+export function validateProviderToolDefinition(value, label = 'provider tool definition') {
+    if (!value || typeof value !== 'object' || Array.isArray(value)) {
+        throw new Error(`${label} must be an object`);
+    }
+    const record = value;
+    const inputSchema = record.inputSchema;
+    if (!inputSchema || typeof inputSchema !== 'object' || Array.isArray(inputSchema)) {
+        throw new Error(`${label}.inputSchema must be an object`);
+    }
+    if (record.source !== 'core' && record.source !== 'plugin') {
+        throw new Error(`${label}.source must be "core" or "plugin"`);
+    }
+    return {
+        id: validateNonEmptyString(record.id, `${label}.id`),
+        name: validateNonEmptyString(record.name, `${label}.name`),
+        description: validateNonEmptyString(record.description, `${label}.description`),
+        inputSchema: inputSchema,
+        ...(record.requiredCapability !== undefined ? { requiredCapability: record.requiredCapability } : {}),
+        source: record.source,
+        ...(record.ownerPackageId !== undefined ? { ownerPackageId: validatePackageId(record.ownerPackageId, `${label}.ownerPackageId`) } : {})
+    };
+}
+function validateProviderNativeToolDocumentation(value, label) {
+    if (value === undefined) {
+        return undefined;
+    }
+    if (!value || typeof value !== 'object' || Array.isArray(value)) {
+        throw new Error(`${label} must be an object when provided`);
+    }
+    const record = value;
+    return {
+        nativeToolNames: validateOptionalStringArray(record.nativeToolNames, `${label}.nativeToolNames`) ?? [],
+        defaultWorkspacePreset: validateNonEmptyString(record.defaultWorkspacePreset, `${label}.defaultWorkspacePreset`),
+        defaultEphemeralPreset: validateNonEmptyString(record.defaultEphemeralPreset, `${label}.defaultEphemeralPreset`),
+        grantMapping: validateNonEmptyString(record.grantMapping, `${label}.grantMapping`)
+    };
+}
 export function validateProviderPackageRuntimeContract(pkg) {
     if (typeof pkg.createProviderFactory !== 'function') {
         throw new Error(`Provider package ${pkg.manifest.id} must implement createProviderFactory`);

package/dist/provider.js.map

@@ -1 +1 @@
-{"version":3,"file":"provider.js","sourceRoot":"","sources":["../src/provider.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,sBAAsB,EAAE,6BAA6B,EAAE,2BAA2B,EAAE,iBAAiB,EAAE,MAAM,cAAc,CAAC;AAuGrI,MAAM,UAAU,+BAA+B,CAAC,QAAiC;IAC/E,IAAI,CAAC,QAAQ,IAAI,OAAO,QAAQ,KAAK,QAAQ,IAAI,KAAK,CAAC,OAAO,CAAC,QAAQ,CAAC,EAAE,CAAC;QACzE,MAAM,IAAI,KAAK,CAAC,6CAA6C,CAAC,CAAC;IACjE,CAAC;IACD,MAAM,MAAM,GAAG,QAA8C,CAAC;IAC9D,iBAAiB,CAAC,MAAM,CAAC,EAAE,EAAE,8BAA8B,CAAC,CAAC;IAC7D,IAAI,OAAO,MAAM,CAAC,IAAI,KAAK,QAAQ,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,EAAE,EAAE,CAAC;QAC3D,MAAM,IAAI,KAAK,CAAC,4CAA4C,CAAC,CAAC;IAChE,CAAC;IACD,IAAI,OAAO,MAAM,CAAC,OAAO,KAAK,QAAQ,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC,IAAI,EAAE,EAAE,CAAC;QACjE,MAAM,IAAI,KAAK,CAAC,+CAA+C,CAAC,CAAC;IACnE,CAAC;IACD,IAAI,MAAM,CAAC,IAAI,KAAK,UAAU,EAAE,CAAC;QAC/B,MAAM,IAAI,KAAK,CAAC,mDAAmD,CAAC,CAAC;IACvE,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,uEAAuE,CAAC,CAAC;IAC3F,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,sEAAsE,CAAC,CAAC;IAC1F,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,2EAA2E,CAAC,CAAC;IAC/F,CAAC;IACD,2BAA2B,CAAC,MAAM,CAAC,YAAY,EAAE,2BAA2B,CAAC,CAAC;IAC9E,sBAAsB,CAAC,MAAM,CAAC,YAAY,EAAE,2BAA2B,CAAC,CAAC;IACzE,MAAM,UAAU,GAAG,6BAA6B,CAAC,MAAM,CAAC,UAAU,EAAE,2BAA2B,CAAC,CAAC;IACjG,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;AAED,MAAM,UAAU,sCAAsC,CAAC,GAA2B;IAChF,IAAI,OAAO,GAAG,CAAC,qBAAqB,KAAK,UAAU,EAAE,CAAC;QACpD,MAAM,IAAI,KAAK,CAAC,oBAAoB,GAAG,CAAC,QAAQ,CAAC,EAAE,uCAAuC,CAAC,CAAC;IAC9F,CAAC;IACD,IAAI,GAAG,CAAC,yBAAyB,KAAK,SAAS,IAAI,OAAO,GAAG,CAAC,yBAAyB,KAAK,UAAU,EAAE,CAAC;QACvG,MAAM,IAAI,KAAK,CAAC,oBAAoB,GAAG,CAAC,QAAQ,CAAC,EAAE,6CAA6C,CAAC,CAAC;IACpG,CAAC;AACH,CAAC"}
+{"version":3,"file":"provider.js","sourceRoot":"","sources":["../src/provider.ts"],"names":[],"mappings":"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"}

package/dist/runtime.d.ts

@@ -7,8 +7,14 @@ export interface RuntimeCommandRunner {
     run(command: string, args: string[], cwd?: string): Promise<CommandResult>;
 }
 export type RuntimeModeName = 'full-access' | 'approval-required';
+export type RuntimeAgentKind = 'workspace' | 'ephemeral';
 export declare function parseRuntimeModeName(value: unknown, label?: string): RuntimeModeName;
+export declare function parseRuntimeAgentKind(value: unknown, label?: string): RuntimeAgentKind;
 export type ProviderPackageId = string;
+export interface ProviderResumeCursor {
+    provider: ProviderPackageId;
+    value: unknown;
+}
 export type ProviderSessionStatus = 'connecting' | 'ready' | 'running' | 'waiting' | 'error' | 'closed';
 export interface ProviderAccountMetadata {
     accountLabel: string | null;
@@ -36,12 +42,14 @@ export interface ProviderSessionRecord {
     nativeMetadata?: Record<string, unknown>;
     threadId: string;
     runtimeMode: RuntimeModeName;
+    agentKind?: RuntimeAgentKind;
     cwd: string;
     model?: string;
     status: ProviderSessionStatus;
     activeTurnId?: string;
     resumeCursor?: {
         threadId: string;
+        cursor?: ProviderResumeCursor;
     };
     createdAt: string;
     updatedAt: string;
@@ -73,6 +81,7 @@ export type ProviderRuntimeEvent = (ProviderRuntimeEventBase & {
     type: 'thread.started';
     payload: {
         providerThreadId: string;
+        resumeCursor?: ProviderResumeCursor;
     };
 }) | (ProviderRuntimeEventBase & {
     type: 'thread.state.changed';
@@ -163,7 +172,7 @@ export interface PendingRuntimeRequestRecord {
     requestId: string;
     threadId: string;
     turnId: string | null;
-    spaceId: string;
+    transportResourceId: string;
     requesterUserId: string | null;
     messageId: string | null;
     requestType: CanonicalRequestType;

package/dist/runtime.js

@@ -1,4 +1,5 @@
 const RUNTIME_MODE_NAMES = ['full-access', 'approval-required'];
+const RUNTIME_AGENT_KINDS = ['workspace', 'ephemeral'];
 function isRuntimeModeName(value) {
     return value === 'full-access' || value === 'approval-required';
 }
@@ -8,4 +9,13 @@ export function parseRuntimeModeName(value, label = 'runtime_mode') {
     }
     throw new Error(`${label} must be one of: ${RUNTIME_MODE_NAMES.join(', ')}.`);
 }
+function isRuntimeAgentKind(value) {
+    return value === 'workspace' || value === 'ephemeral';
+}
+export function parseRuntimeAgentKind(value, label = 'agent_kind') {
+    if (isRuntimeAgentKind(value)) {
+        return value;
+    }
+    throw new Error(`${label} must be one of: ${RUNTIME_AGENT_KINDS.join(', ')}.`);
+}
 //# sourceMappingURL=runtime.js.map

package/dist/runtime.js.map

@@ -1 +1 @@
-{"version":3,"file":"runtime.js","sourceRoot":"","sources":["../src/runtime.ts"],"names":[],"mappings":"AAYA,MAAM,kBAAkB,GAAsB,CAAC,aAAa,EAAE,mBAAmB,CAAC,CAAC;AAEnF,SAAS,iBAAiB,CAAC,KAAc;IACvC,OAAO,KAAK,KAAK,aAAa,IAAI,KAAK,KAAK,mBAAmB,CAAC;AAClE,CAAC;AAED,MAAM,UAAU,oBAAoB,CAAC,KAAc,EAAE,KAAK,GAAG,cAAc;IACzE,IAAI,iBAAiB,CAAC,KAAK,CAAC,EAAE,CAAC;QAC7B,OAAO,KAAK,CAAC;IACf,CAAC;IACD,MAAM,IAAI,KAAK,CAAC,GAAG,KAAK,oBAAoB,kBAAkB,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AAChF,CAAC"}
+{"version":3,"file":"runtime.js","sourceRoot":"","sources":["../src/runtime.ts"],"names":[],"mappings":"AAaA,MAAM,kBAAkB,GAAsB,CAAC,aAAa,EAAE,mBAAmB,CAAC,CAAC;AACnF,MAAM,mBAAmB,GAAuB,CAAC,WAAW,EAAE,WAAW,CAAC,CAAC;AAE3E,SAAS,iBAAiB,CAAC,KAAc;IACvC,OAAO,KAAK,KAAK,aAAa,IAAI,KAAK,KAAK,mBAAmB,CAAC;AAClE,CAAC;AAED,MAAM,UAAU,oBAAoB,CAAC,KAAc,EAAE,KAAK,GAAG,cAAc;IACzE,IAAI,iBAAiB,CAAC,KAAK,CAAC,EAAE,CAAC;QAC7B,OAAO,KAAK,CAAC;IACf,CAAC;IACD,MAAM,IAAI,KAAK,CAAC,GAAG,KAAK,oBAAoB,kBAAkB,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AAChF,CAAC;AAED,SAAS,kBAAkB,CAAC,KAAc;IACxC,OAAO,KAAK,KAAK,WAAW,IAAI,KAAK,KAAK,WAAW,CAAC;AACxD,CAAC;AAED,MAAM,UAAU,qBAAqB,CAAC,KAAc,EAAE,KAAK,GAAG,YAAY;IACxE,IAAI,kBAAkB,CAAC,KAAK,CAAC,EAAE,CAAC;QAC9B,OAAO,KAAK,CAAC;IACf,CAAC;IACD,MAAM,IAAI,KAAK,CAAC,GAAG,KAAK,oBAAoB,mBAAmB,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AACjF,CAAC"}

package/dist/transport.d.ts

@@ -1,16 +1,9 @@
 import type { JsonSchemaLike, PackageDependency, PackageManifestBase } from './package.js';
-import type { RuntimeCommandRunner } from './runtime.js';
+import type { RuntimeCommandRunner, RuntimeModeName } from './runtime.js';
+import type { RuntimeExternalResourceRef } from './external.js';
 export type RuntimeScopeId = string;
-export type RuntimeSpaceId = string;
+export type RuntimeTransportResourceId = string;
 export type RuntimeThreadId = string;
-export interface RuntimeSurfaceNames {
-    mainCategoryName: string;
-    chatChannelName: string;
-    statusChannelName: string;
-    sessionsCategoryName: string;
-    missionsCategoryName: string;
-    archiveCategoryName: string;
-}
 export interface ManagedAdminAccessGroupConfig {
     enabled: boolean;
     name: string;
@@ -24,7 +17,7 @@ export interface RuntimeAccessGroupRecord {
     id: string;
     kind: RuntimeAccessGroupKind;
     name: string;
-    verifiedAt?: string;
+    syncedAt?: string;
     metadata?: Record<string, unknown>;
 }
 export interface RuntimeAccessGroupInput {
@@ -36,18 +29,9 @@ export interface RuntimeAccessGroupInput {
 }
 export interface RuntimeSurfaceState {
     scopeId?: string;
-    mainCategoryId: string;
-    chatChannelId: string;
-    statusChannelId: string;
-    sessionsCategoryId: string;
-    missionsCategoryId: string;
-    archiveCategoryId: string;
-    adminAccessGroupId?: string;
-    memberAccessGroupId?: string;
-    adminAccessGroupName?: string;
-    memberAccessGroupName?: string;
-    adminAccessGroupVerifiedAt?: string;
-    memberAccessGroupVerifiedAt?: string;
+    surfaceId: string;
+    statusResourceId?: string;
+    coordinationResourceId?: string;
     createdAt: string;
     updatedAt: string;
     metadata?: Record<string, unknown>;
@@ -55,7 +39,6 @@ export interface RuntimeSurfaceState {
 export interface RuntimeSurfaceBootstrapInput {
     scopeId?: RuntimeScopeId;
     actorId?: string;
-    names?: Partial<RuntimeSurfaceNames>;
     managedAdminAccessGroup?: ManagedAdminAccessGroupConfig;
     managedMemberAccessGroup?: ManagedMemberAccessGroupConfig;
     explicitAdminRoleIds?: string[];
@@ -71,13 +54,18 @@ export interface RuntimeActorIdentity {
     isSurfaceAdmin?: boolean;
     transportMetadata?: Record<string, unknown>;
 }
-export interface RuntimeSpaceRecord {
-    id: RuntimeSpaceId;
+export interface RuntimeTransportResourceRecord {
+    id: RuntimeTransportResourceId;
     name: string;
-    kind: 'root' | 'group' | 'room' | 'thread' | 'dm' | 'external';
-    parentId: RuntimeSpaceId | null;
+    kind: 'root' | 'collection' | 'conversation' | 'item' | 'direct' | 'external';
+    parentId: RuntimeTransportResourceId | null;
     metadata?: Record<string, unknown>;
 }
+export interface RuntimeTransportSessionOwner {
+    kind: 'run' | 'work_item' | 'external_resource' | 'operator';
+    id: string;
+    label?: string;
+}
 export interface RuntimeAttachmentPayload {
     kind: 'file' | 'image' | 'link';
     path?: string;
@@ -129,27 +117,64 @@ export interface RuntimeNativeInteraction {
     id?: string;
     payload?: unknown;
 }
-export type RuntimeTransportEvent = {
-    type: 'message.received';
+export interface RuntimeTransportIntentBase {
+    intentId: string;
     scopeId: RuntimeScopeId;
-    spaceId: RuntimeSpaceId;
+    transportPackageId?: string;
+    occurredAt: string;
+    native?: RuntimeNativeInteraction;
+    metadata?: Record<string, unknown>;
+}
+export type RuntimeTransportIntent = {
+    type: 'transport.message.received';
+    transportResourceId: RuntimeTransportResourceId;
     actor: RuntimeActorIdentity;
     message: RuntimeInboundMessage;
-} | {
-    type: 'action.invoked';
-    scopeId: RuntimeScopeId;
-    spaceId?: RuntimeSpaceId;
+} & RuntimeTransportIntentBase | {
+    type: 'transport.action.invoked';
+    transportResourceId?: RuntimeTransportResourceId;
     actor: RuntimeActorIdentity;
     actionId: string;
     input: Record<string, unknown>;
-    native?: RuntimeNativeInteraction;
-} | {
-    type: 'resource.lifecycle';
-    scopeId: RuntimeScopeId;
-    resource: RuntimeSpaceRecord;
+} & RuntimeTransportIntentBase | {
+    type: 'transport.session.ensure';
+    transportResourceId: RuntimeTransportResourceId;
+    requestedName: string;
+    actor?: RuntimeActorIdentity;
+    runtimeMode?: RuntimeModeName;
+    initialMessage?: RuntimeInboundMessage;
+    owner?: RuntimeTransportSessionOwner;
+} & RuntimeTransportIntentBase | {
+    type: 'transport.session.delete';
+    transportResourceId: RuntimeTransportResourceId;
+    actor?: RuntimeActorIdentity;
+    reason: string;
+    deleteWorkspace: boolean;
+} & RuntimeTransportIntentBase | {
+    type: 'transport.session.archive';
+    transportResourceId: RuntimeTransportResourceId;
+    actor?: RuntimeActorIdentity;
+    reason: string;
+} & RuntimeTransportIntentBase | {
+    type: 'transport.session.resume';
+    transportResourceId: RuntimeTransportResourceId;
+    actor?: RuntimeActorIdentity;
+    reason: string;
+} & RuntimeTransportIntentBase | {
+    type: 'transport.resource.observed';
+    resource: RuntimeTransportResourceRecord;
     action: 'created' | 'updated' | 'deleted';
-    previous?: Partial<RuntimeSpaceRecord>;
-};
+    previous?: Partial<RuntimeTransportResourceRecord>;
+} & RuntimeTransportIntentBase | {
+    type: 'transport.external.received';
+    actor?: RuntimeActorIdentity;
+    source: string;
+    eventName: string;
+    resource?: RuntimeExternalResourceRef;
+    payload: unknown;
+    receivedAt: string;
+    idempotencyKey?: string;
+} & RuntimeTransportIntentBase;
 export interface RuntimeTransportAccessInput {
     authToken?: string;
     scopeId: RuntimeScopeId;
@@ -170,12 +195,12 @@ export interface RuntimeTransportAuth {
 }
 export interface RuntimeMessageTarget {
     scopeId?: RuntimeScopeId;
-    spaceId: RuntimeSpaceId;
+    transportResourceId: RuntimeTransportResourceId;
     threadId?: RuntimeThreadId;
 }
 export interface RuntimeTransportCapabilities {
     nativeActions: boolean;
-    spaces: {
+    resources: {
         list: boolean;
         create: boolean;
         update: boolean;
@@ -186,27 +211,27 @@ export interface RuntimeTransportCapabilities {
     maxAttachmentBytes?: number;
     metadata?: Record<string, unknown>;
 }
-export interface RuntimeCreateSpaceInput {
+export interface RuntimeCreateTransportResourceInput {
     scopeId: RuntimeScopeId;
     name: string;
-    kind: RuntimeSpaceRecord['kind'];
-    parentId?: RuntimeSpaceId | null;
+    kind: RuntimeTransportResourceRecord['kind'];
+    parentId?: RuntimeTransportResourceId | null;
     metadata?: Record<string, unknown>;
 }
-export interface RuntimeUpdateSpaceInput {
+export interface RuntimeUpdateTransportResourceInput {
     scopeId: RuntimeScopeId;
-    spaceId: RuntimeSpaceId;
+    transportResourceId: RuntimeTransportResourceId;
     name?: string;
-    parentId?: RuntimeSpaceId | null;
+    parentId?: RuntimeTransportResourceId | null;
     metadata?: Record<string, unknown>;
 }
-export interface RuntimeDeleteSpaceInput {
+export interface RuntimeDeleteTransportResourceInput {
     scopeId: RuntimeScopeId;
-    spaceId: RuntimeSpaceId;
+    transportResourceId: RuntimeTransportResourceId;
 }
 export interface RuntimePresenceInput {
     scopeId?: RuntimeScopeId;
-    spaceId?: RuntimeSpaceId;
+    transportResourceId?: RuntimeTransportResourceId;
     status: 'online' | 'idle' | 'busy' | 'offline';
     text?: string;
 }
@@ -214,6 +239,39 @@ export interface RuntimeNativeActionRegistration {
     scopeId: RuntimeScopeId;
     actions: RuntimeActionDefinition[];
 }
+export type RuntimeTransportEffect = {
+    type: 'transport.message.send';
+    target: RuntimeMessageTarget;
+    payload: RuntimeMessagePayload;
+} & RuntimeTransportEffectBase | {
+    type: 'transport.resource.create';
+    input: RuntimeCreateTransportResourceInput;
+} & RuntimeTransportEffectBase | {
+    type: 'transport.resource.update';
+    input: RuntimeUpdateTransportResourceInput;
+} & RuntimeTransportEffectBase | {
+    type: 'transport.resource.delete';
+    input: RuntimeDeleteTransportResourceInput;
+} & RuntimeTransportEffectBase | {
+    type: 'transport.presence.set';
+    input: RuntimePresenceInput;
+} & RuntimeTransportEffectBase | {
+    type: 'transport.actions.register';
+    input: RuntimeNativeActionRegistration;
+} & RuntimeTransportEffectBase;
+export interface RuntimeTransportEffectBase {
+    effectId: string;
+    scopeId?: RuntimeScopeId;
+    createdAt: string;
+    reason?: string;
+    metadata?: Record<string, unknown>;
+}
+export interface RuntimeTransportEffectReceipt {
+    effectId: string;
+    appliedAt: string;
+    nativeId?: string;
+    metadata?: Record<string, unknown>;
+}
 export interface RuntimeActionDefinition {
     id: string;
     title: string;
@@ -231,16 +289,8 @@ export interface RuntimeTransport {
     start(auth: RuntimeTransportAuth): Promise<void>;
     stop(): Promise<void>;
     capabilities(): RuntimeTransportCapabilities;
-    onEvent(handler: (event: RuntimeTransportEvent) => Promise<void>): void;
-    sendMessage(target: RuntimeMessageTarget, payload: RuntimeMessagePayload): Promise<RuntimeMessageReceipt>;
-    listSpaces?(scopeId: RuntimeScopeId): Promise<RuntimeSpaceRecord[]>;
-    createSpace?(input: RuntimeCreateSpaceInput): Promise<RuntimeSpaceRecord>;
-    updateSpace?(input: RuntimeUpdateSpaceInput): Promise<RuntimeSpaceRecord>;
-    deleteSpace?(input: RuntimeDeleteSpaceInput): Promise<void>;
-    setPresence?(input: RuntimePresenceInput): Promise<void>;
-    registerNativeActions?(input: RuntimeNativeActionRegistration): Promise<void>;
-    ensureAccessGroup?(input: RuntimeAccessGroupInput): Promise<RuntimeAccessGroupRecord>;
-    reconcileRuntimeSurface?(input: RuntimeSurfaceBootstrapInput): Promise<RuntimeSurfaceState>;
+    onIntent?(handler: (intent: RuntimeTransportIntent) => Promise<void>): void;
+    applyEffect(effect: RuntimeTransportEffect): Promise<RuntimeTransportEffectReceipt>;
 }
 export interface TransportPackageManifest extends PackageManifestBase {
     type: 'transport';

package/dist/transport.js.map

@@ -1 +1 @@
-{"version":3,"file":"transport.js","sourceRoot":"","sources":["../src/transport.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,sBAAsB,EAAE,6BAA6B,EAAE,2BAA2B,EAAE,iBAAiB,EAAE,MAAM,cAAc,CAAC;AAiTrI,MAAM,UAAU,gCAAgC,CAAC,QAAkC;IACjF,IAAI,CAAC,QAAQ,IAAI,OAAO,QAAQ,KAAK,QAAQ,IAAI,KAAK,CAAC,OAAO,CAAC,QAAQ,CAAC,EAAE,CAAC;QACzE,MAAM,IAAI,KAAK,CAAC,8CAA8C,CAAC,CAAC;IAClE,CAAC;IACD,MAAM,MAAM,GAAG,QAA8C,CAAC;IAC9D,iBAAiB,CAAC,MAAM,CAAC,EAAE,EAAE,+BAA+B,CAAC,CAAC;IAC9D,IAAI,OAAO,MAAM,CAAC,IAAI,KAAK,QAAQ,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,EAAE,EAAE,CAAC;QAC3D,MAAM,IAAI,KAAK,CAAC,6CAA6C,CAAC,CAAC;IACjE,CAAC;IACD,IAAI,OAAO,MAAM,CAAC,OAAO,KAAK,QAAQ,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC,IAAI,EAAE,EAAE,CAAC;QACjE,MAAM,IAAI,KAAK,CAAC,gDAAgD,CAAC,CAAC;IACpE,CAAC;IACD,IAAI,MAAM,CAAC,IAAI,KAAK,WAAW,EAAE,CAAC;QAChC,MAAM,IAAI,KAAK,CAAC,qDAAqD,CAAC,CAAC;IACzE,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,wEAAwE,CAAC,CAAC;IAC5F,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,uEAAuE,CAAC,CAAC;IAC3F,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,4EAA4E,CAAC,CAAC;IAChG,CAAC;IACD,2BAA2B,CAAC,MAAM,CAAC,YAAY,EAAE,4BAA4B,CAAC,CAAC;IAC/E,sBAAsB,CAAC,MAAM,CAAC,YAAY,EAAE,4BAA4B,CAAC,CAAC;IAC1E,MAAM,UAAU,GAAG,6BAA6B,CAAC,MAAM,CAAC,UAAU,EAAE,4BAA4B,CAAC,CAAC;IAClG,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;AAED,MAAM,UAAU,uCAAuC,CAAC,GAA4B;IAClF,IAAI,OAAO,GAAG,CAAC,eAAe,KAAK,UAAU,EAAE,CAAC;QAC9C,MAAM,IAAI,KAAK,CAAC,qBAAqB,GAAG,CAAC,QAAQ,CAAC,EAAE,iCAAiC,CAAC,CAAC;IACzF,CAAC;IACD,IAAI,GAAG,CAAC,cAAc,KAAK,SAAS,IAAI,OAAO,GAAG,CAAC,cAAc,KAAK,UAAU,EAAE,CAAC;QACjF,MAAM,IAAI,KAAK,CAAC,qBAAqB,GAAG,CAAC,QAAQ,CAAC,EAAE,kDAAkD,CAAC,CAAC;IAC1G,CAAC;AACH,CAAC"}
+{"version":3,"file":"transport.js","sourceRoot":"","sources":["../src/transport.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,sBAAsB,EAAE,6BAA6B,EAAE,2BAA2B,EAAE,iBAAiB,EAAE,MAAM,cAAc,CAAC;AAkXrI,MAAM,UAAU,gCAAgC,CAAC,QAAkC;IACjF,IAAI,CAAC,QAAQ,IAAI,OAAO,QAAQ,KAAK,QAAQ,IAAI,KAAK,CAAC,OAAO,CAAC,QAAQ,CAAC,EAAE,CAAC;QACzE,MAAM,IAAI,KAAK,CAAC,8CAA8C,CAAC,CAAC;IAClE,CAAC;IACD,MAAM,MAAM,GAAG,QAA8C,CAAC;IAC9D,iBAAiB,CAAC,MAAM,CAAC,EAAE,EAAE,+BAA+B,CAAC,CAAC;IAC9D,IAAI,OAAO,MAAM,CAAC,IAAI,KAAK,QAAQ,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,EAAE,EAAE,CAAC;QAC3D,MAAM,IAAI,KAAK,CAAC,6CAA6C,CAAC,CAAC;IACjE,CAAC;IACD,IAAI,OAAO,MAAM,CAAC,OAAO,KAAK,QAAQ,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC,IAAI,EAAE,EAAE,CAAC;QACjE,MAAM,IAAI,KAAK,CAAC,gDAAgD,CAAC,CAAC;IACpE,CAAC;IACD,IAAI,MAAM,CAAC,IAAI,KAAK,WAAW,EAAE,CAAC;QAChC,MAAM,IAAI,KAAK,CAAC,qDAAqD,CAAC,CAAC;IACzE,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,wEAAwE,CAAC,CAAC;IAC5F,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,uEAAuE,CAAC,CAAC;IAC3F,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,4EAA4E,CAAC,CAAC;IAChG,CAAC;IACD,2BAA2B,CAAC,MAAM,CAAC,YAAY,EAAE,4BAA4B,CAAC,CAAC;IAC/E,sBAAsB,CAAC,MAAM,CAAC,YAAY,EAAE,4BAA4B,CAAC,CAAC;IAC1E,MAAM,UAAU,GAAG,6BAA6B,CAAC,MAAM,CAAC,UAAU,EAAE,4BAA4B,CAAC,CAAC;IAClG,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;AAED,MAAM,UAAU,uCAAuC,CAAC,GAA4B;IAClF,IAAI,OAAO,GAAG,CAAC,eAAe,KAAK,UAAU,EAAE,CAAC;QAC9C,MAAM,IAAI,KAAK,CAAC,qBAAqB,GAAG,CAAC,QAAQ,CAAC,EAAE,iCAAiC,CAAC,CAAC;IACzF,CAAC;IACD,IAAI,GAAG,CAAC,cAAc,KAAK,SAAS,IAAI,OAAO,GAAG,CAAC,cAAc,KAAK,UAAU,EAAE,CAAC;QACjF,MAAM,IAAI,KAAK,CAAC,qBAAqB,GAAG,CAAC,QAAQ,CAAC,EAAE,kDAAkD,CAAC,CAAC;IAC1G,CAAC;AACH,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@moorline/contracts",
-  "version": "0.0.1",
+  "version": "0.0.3",
   "description": "Moorline package and runtime contract definitions",
   "type": "module",
   "private": false,
@@ -27,5 +27,8 @@
     "type": "git",
     "url": "git+ssh://git@github.com/Moorline/moorline.git",
     "directory": "packages/contracts"
-  }
+  },
+  "keywords": [
+    "moorline-package"
+  ]
 }