@lineai/agent-platform-types 0.1.0

package/build/main/task.js

@@ -0,0 +1,170 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.FALLBACK_DEFAULTS = exports.ResolvedTaskDefinitionSchema = exports.TaskSubmissionSchema = exports.TaskOverridesSchema = exports.TaskSubmissionDefinitionSchema = exports.TaskModeSchema = exports.InputFileSchema = exports.RuntimeSubagentSchema = exports.RuntimeMcpServerConfigSchema = void 0;
+const zod_1 = require("zod");
+const capabilities_1 = require("./capabilities");
+const plugin_1 = require("./plugin");
+/**
+ * Task schemas — three distinct shapes:
+ *
+ * 1. TaskSubmissionSchema      — slim shape clients send to the API. Plugin
+ *                                defaults supply most config; only per-task
+ *                                inputs and overrides are required.
+ *
+ * 2. ResolvedTaskDefinitionSchema — rich shape produced by the orchestrator
+ *                                merger and consumed by the runtime. This is
+ *                                what gets written to GCS as definition.json.
+ *
+ * 3. TaskRunMcpServerConfigSchema / RuntimeSubagentSchema — pieces shared by
+ *                                both shapes.
+ */
+// ---------- Runtime MCP server config (stdio + http) ----------
+exports.RuntimeMcpServerConfigSchema = zod_1.z.object({
+    type: zod_1.z.enum(['stdio', 'http']),
+    command: zod_1.z.string().optional(),
+    args: zod_1.z.array(zod_1.z.string()).optional(),
+    url: zod_1.z.string().url().optional(),
+    headers: zod_1.z.record(zod_1.z.string()).optional(),
+    env: zod_1.z.record(zod_1.z.string()).optional(),
+    description: zod_1.z.string().optional(),
+});
+// ---------- Runtime subagent (flattened, what the SDK consumes) ----------
+exports.RuntimeSubagentSchema = zod_1.z.object({
+    description: zod_1.z.string(),
+    prompt: zod_1.z.string(),
+    tools: zod_1.z.array(zod_1.z.string()).optional(),
+    model: zod_1.z.string().optional(),
+});
+// ---------- Input/output ----------
+exports.InputFileSchema = zod_1.z.object({
+    source: zod_1.z.string(),
+    destination: zod_1.z.string(),
+});
+exports.TaskModeSchema = zod_1.z.enum(['execute', 'codegen', 'review']);
+// ---------- Task submission (what clients send) ----------
+/**
+ * The slim shape line-ai (and any other client) submits to the API.
+ *
+ * Plugin-owned fields (model, maxTurns, persona, tools, capabilities,
+ * subagents, skills, etc.) are intentionally absent — they live on the
+ * project's plugin defaults document and are merged in by the orchestrator.
+ *
+ * The four capability fields (integrations, collections, contextFiles,
+ * memoryCards) and mcpServers MAY appear here; capability fields use
+ * replace-semantics over plugin defaults, while mcpServers are additive
+ * to the plugin catalog (task entries win on key collision).
+ */
+exports.TaskSubmissionDefinitionSchema = zod_1.z.object({
+    // Required
+    id: zod_1.z
+        .string()
+        .regex(/^[a-z][a-z0-9-]{0,62}$/, 'ID must start with a lowercase letter and contain only lowercase letters, numbers, and hyphens'),
+    name: zod_1.z.string().max(200),
+    instructions: zod_1.z.string().min(10),
+    // Per-run I/O
+    inputFiles: zod_1.z.array(exports.InputFileSchema).optional(),
+    outputPatterns: zod_1.z.array(zod_1.z.string()).optional(),
+    mode: exports.TaskModeSchema.optional(),
+    // Trigger payload / arbitrary runtime context
+    context: zod_1.z.record(zod_1.z.unknown()).optional(),
+    // Capability overrides (replace-semantics — when present, plugin defaults
+    // for the same field are ignored entirely).
+    integrations: zod_1.z.array(capabilities_1.ConnectedIntegrationSchema).optional(),
+    collections: zod_1.z.array(capabilities_1.CollectionAccessSchema).optional(),
+    contextFiles: zod_1.z.array(capabilities_1.ContextFileRefSchema).optional(),
+    memoryCards: zod_1.z.array(capabilities_1.MemoryCardRefSchema).optional(),
+    // Additive MCP servers — merged with plugin['mcp-servers'].servers.
+    // Task entries win on key collision. Allowed shapes: the plugin http shape
+    // for parity with the editor, or the runtime stdio/http shape.
+    mcpServers: zod_1.z
+        .record(zod_1.z.union([plugin_1.PluginMcpServerEntrySchema, exports.RuntimeMcpServerConfigSchema]))
+        .optional(),
+});
+exports.TaskOverridesSchema = zod_1.z.object({
+    instructions: zod_1.z.string().optional(),
+    inputFiles: zod_1.z.array(exports.InputFileSchema).optional(),
+});
+exports.TaskSubmissionSchema = zod_1.z
+    .object({
+    definition: exports.TaskSubmissionDefinitionSchema.optional(),
+    workflowRef: zod_1.z.string().optional(),
+    taskRef: zod_1.z.string().optional(),
+    overrides: exports.TaskOverridesSchema.optional(),
+    context: zod_1.z.record(zod_1.z.unknown()).optional(),
+    idempotencyKey: zod_1.z.string().optional(),
+    resumeSessionId: zod_1.z.string().optional(),
+    callbackUrl: zod_1.z.string().url().optional(),
+})
+    .refine((s) => !!(s.definition || s.workflowRef || s.taskRef), 'Task submission requires one of: definition, workflowRef, taskRef');
+// ---------- Resolved task definition (what the runtime executes) ----------
+/**
+ * The rich shape produced by the orchestrator merger and consumed by the
+ * runtime. Plugin defaults + submission have been merged; subagents are
+ * flattened to RuntimeSubagent shape; skills carry full bodies for
+ * materialization into .claude/skills/{id}/SKILL.md.
+ *
+ * This is the schema the runtime validates after downloading definition.json.
+ */
+exports.ResolvedTaskDefinitionSchema = zod_1.z.object({
+    // Identity
+    id: zod_1.z.string(),
+    name: zod_1.z.string().max(200),
+    instructions: zod_1.z.string().min(10),
+    // Execution config (filled by merger from plugin defaults / FALLBACK_DEFAULTS)
+    model: zod_1.z.string(),
+    maxTurns: zod_1.z.number().min(1).max(500),
+    timeoutSeconds: zod_1.z.number().min(60).max(86400),
+    workingDir: zod_1.z.string(),
+    mode: exports.TaskModeSchema,
+    // System prompt
+    systemPrompt: zod_1.z.string().optional(),
+    systemPromptRef: zod_1.z.string().optional(),
+    persona: zod_1.z.string().optional(),
+    constraints: zod_1.z.array(zod_1.z.string()).optional(),
+    // Tool restrictions
+    allowedTools: zod_1.z.array(zod_1.z.string()).optional(),
+    disabledTools: zod_1.z.array(zod_1.z.string()).optional(),
+    // SDK features
+    capabilities: plugin_1.PluginCapabilitiesSchema.optional(),
+    betas: zod_1.z.array(zod_1.z.string()).optional(),
+    // Per-run I/O
+    inputFiles: zod_1.z.array(exports.InputFileSchema).optional(),
+    outputPatterns: zod_1.z.array(zod_1.z.string()).optional(),
+    context: zod_1.z.record(zod_1.z.unknown()).optional(),
+    // Plugin-resolved fields
+    skills: zod_1.z.array(plugin_1.SkillSchema).optional(),
+    agents: zod_1.z.record(exports.RuntimeSubagentSchema).optional(),
+    mcpServers: zod_1.z
+        .record(zod_1.z.union([exports.RuntimeMcpServerConfigSchema, zod_1.z.string()]))
+        .optional(),
+    // Capability authoring shapes (kept for capabilities-resolver to consume)
+    integrations: zod_1.z.array(capabilities_1.ConnectedIntegrationSchema).optional(),
+    collections: zod_1.z.array(capabilities_1.CollectionAccessSchema).optional(),
+    contextFiles: zod_1.z.array(capabilities_1.ContextFileRefSchema).optional(),
+    memoryCards: zod_1.z.array(capabilities_1.MemoryCardRefSchema).optional(),
+    // Resolved capability metadata (injected by capabilities-resolver)
+    resolvedCapabilities: capabilities_1.ResolvedCapabilitiesSchema.optional(),
+});
+// ---------- Fallback defaults (single source of truth) ----------
+/**
+ * Platform-wide fallback defaults applied by the merger when neither the
+ * task submission nor plugin defaults supply a value. Change them here and
+ * every consumer (orchestrator, runtime, service-api, line-ai) picks them
+ * up on the next package release.
+ *
+ * Anything intentionally unset (systemPrompt, persona, constraints, tool
+ * restrictions, capability bundles, betas, integrations, collections,
+ * contextFiles, memoryCards) has no fallback — undefined means the agent
+ * runs without that feature.
+ */
+exports.FALLBACK_DEFAULTS = {
+    model: 'claude-sonnet-4-6',
+    maxTurns: 100,
+    timeoutSeconds: 3600,
+    workingDir: '/workspace',
+    mode: 'execute',
+    capabilities: {
+        promptCaching: true,
+    },
+};
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoidGFzay5qcyIsInNvdXJjZVJvb3QiOiIiLCJzb3VyY2VzIjpbIi4uLy4uL3NyYy90YXNrLnRzIl0sIm5hbWVzIjpbXSwibWFwcGluZ3MiOiI7OztBQUFBLDZCQUF3QjtBQUN4QixpREFNd0I7QUFDeEIscUNBSWtCO0FBRWxCOzs7Ozs7Ozs7Ozs7O0dBYUc7QUFFSCxpRUFBaUU7QUFFcEQsUUFBQSw0QkFBNEIsR0FBRyxPQUFDLENBQUMsTUFBTSxDQUFDO0lBQ25ELElBQUksRUFBRSxPQUFDLENBQUMsSUFBSSxDQUFDLENBQUMsT0FBTyxFQUFFLE1BQU0sQ0FBQyxDQUFDO0lBQy9CLE9BQU8sRUFBRSxPQUFDLENBQUMsTUFBTSxFQUFFLENBQUMsUUFBUSxFQUFFO0lBQzlCLElBQUksRUFBRSxPQUFDLENBQUMsS0FBSyxDQUFDLE9BQUMsQ0FBQyxNQUFNLEVBQUUsQ0FBQyxDQUFDLFFBQVEsRUFBRTtJQUNwQyxHQUFHLEVBQUUsT0FBQyxDQUFDLE1BQU0sRUFBRSxDQUFDLEdBQUcsRUFBRSxDQUFDLFFBQVEsRUFBRTtJQUNoQyxPQUFPLEVBQUUsT0FBQyxDQUFDLE1BQU0sQ0FBQyxPQUFDLENBQUMsTUFBTSxFQUFFLENBQUMsQ0FBQyxRQUFRLEVBQUU7SUFDeEMsR0FBRyxFQUFFLE9BQUMsQ0FBQyxNQUFNLENBQUMsT0FBQyxDQUFDLE1BQU0sRUFBRSxDQUFDLENBQUMsUUFBUSxFQUFFO0lBQ3BDLFdBQVcsRUFBRSxPQUFDLENBQUMsTUFBTSxFQUFFLENBQUMsUUFBUSxFQUFFO0NBQ25DLENBQUMsQ0FBQztBQUtILDRFQUE0RTtBQUUvRCxRQUFBLHFCQUFxQixHQUFHLE9BQUMsQ0FBQyxNQUFNLENBQUM7SUFDNUMsV0FBVyxFQUFFLE9BQUMsQ0FBQyxNQUFNLEVBQUU7SUFDdkIsTUFBTSxFQUFFLE9BQUMsQ0FBQyxNQUFNLEVBQUU7SUFDbEIsS0FBSyxFQUFFLE9BQUMsQ0FBQyxLQUFLLENBQUMsT0FBQyxDQUFDLE1BQU0sRUFBRSxDQUFDLENBQUMsUUFBUSxFQUFF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

package/build/module/capabilities.d.ts

@@ -0,0 +1,359 @@
+import { z } from 'zod';
+/**
+ * Capability types — these describe the tenant-scoped resources a task or
+ * plugin default can attach (integrations, collections, context files,
+ * memory cards) and the resolved metadata the orchestrator injects before
+ * the runtime executes.
+ */
+export declare const ConnectedIntegrationSchema: z.ZodObject<{
+    slug: z.ZodString;
+    connectionPath: z.ZodString;
+    name: z.ZodString;
+    logo: z.ZodOptional<z.ZodString>;
+    status: z.ZodString;
+    useAllTools: z.ZodOptional<z.ZodBoolean>;
+    toolSlugs: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+}, "strip", z.ZodTypeAny, {
+    status: string;
+    slug: string;
+    connectionPath: string;
+    name: string;
+    logo?: string | undefined;
+    useAllTools?: boolean | undefined;
+    toolSlugs?: string[] | undefined;
+}, {
+    status: string;
+    slug: string;
+    connectionPath: string;
+    name: string;
+    logo?: string | undefined;
+    useAllTools?: boolean | undefined;
+    toolSlugs?: string[] | undefined;
+}>;
+export type ConnectedIntegration = z.infer<typeof ConnectedIntegrationSchema>;
+export declare const CollectionAccessOpSchema: z.ZodEnum<["list", "read", "create", "update", "delete"]>;
+export type CollectionAccessOp = z.infer<typeof CollectionAccessOpSchema>;
+export declare const CollectionAccessSchema: z.ZodObject<{
+    collectionId: z.ZodString;
+    access: z.ZodArray<z.ZodEnum<["list", "read", "create", "update", "delete"]>, "many">;
+}, "strip", z.ZodTypeAny, {
+    collectionId: string;
+    access: ("create" | "list" | "read" | "update" | "delete")[];
+}, {
+    collectionId: string;
+    access: ("create" | "list" | "read" | "update" | "delete")[];
+}>;
+export type CollectionAccess = z.infer<typeof CollectionAccessSchema>;
+export declare const ContextFileRefSchema: z.ZodObject<{
+    id: z.ZodString;
+    name: z.ZodString;
+    size: z.ZodNumber;
+    type: z.ZodString;
+    gsUrl: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    type: string;
+    size: number;
+    name: string;
+    id: string;
+    gsUrl: string;
+}, {
+    type: string;
+    size: number;
+    name: string;
+    id: string;
+    gsUrl: string;
+}>;
+export type ContextFileRef = z.infer<typeof ContextFileRefSchema>;
+export declare const MemoryCardRefSchema: z.ZodString;
+export type MemoryCardRef = z.infer<typeof MemoryCardRefSchema>;
+export declare const ResolvedIntegrationToolsSchema: z.ZodObject<{
+    tools: z.ZodArray<z.ZodRecord<z.ZodString, z.ZodUnknown>, "many">;
+}, "strip", z.ZodTypeAny, {
+    tools: Record<string, unknown>[];
+}, {
+    tools: Record<string, unknown>[];
+}>;
+export declare const ResolvedCollectionsSchema: z.ZodObject<{
+    items: z.ZodArray<z.ZodObject<{
+        collectionId: z.ZodString;
+        access: z.ZodArray<z.ZodEnum<["list", "read", "create", "update", "delete"]>, "many">;
+    }, "strip", z.ZodTypeAny, {
+        collectionId: string;
+        access: ("create" | "list" | "read" | "update" | "delete")[];
+    }, {
+        collectionId: string;
+        access: ("create" | "list" | "read" | "update" | "delete")[];
+    }>, "many">;
+}, "strip", z.ZodTypeAny, {
+    items: {
+        collectionId: string;
+        access: ("create" | "list" | "read" | "update" | "delete")[];
+    }[];
+}, {
+    items: {
+        collectionId: string;
+        access: ("create" | "list" | "read" | "update" | "delete")[];
+    }[];
+}>;
+export declare const ResolvedContextFilesSchema: z.ZodObject<{
+    files: z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        name: z.ZodString;
+        gsUrl: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        name: string;
+        id: string;
+        gsUrl: string;
+    }, {
+        name: string;
+        id: string;
+        gsUrl: string;
+    }>, "many">;
+}, "strip", z.ZodTypeAny, {
+    files: {
+        name: string;
+        id: string;
+        gsUrl: string;
+    }[];
+}, {
+    files: {
+        name: string;
+        id: string;
+        gsUrl: string;
+    }[];
+}>;
+export declare const ResolvedMemoryCardSchema: z.ZodObject<{
+    id: z.ZodString;
+    name: z.ZodString;
+    scope: z.ZodEnum<["user", "organization"]>;
+    createdBy: z.ZodString;
+    datasetId: z.ZodOptional<z.ZodString>;
+    description: z.ZodOptional<z.ZodString>;
+    cogneeUrl: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    name: string;
+    id: string;
+    scope: "user" | "organization";
+    createdBy: string;
+    cogneeUrl: string;
+    description?: string | undefined;
+    datasetId?: string | undefined;
+}, {
+    name: string;
+    id: string;
+    scope: "user" | "organization";
+    createdBy: string;
+    cogneeUrl: string;
+    description?: string | undefined;
+    datasetId?: string | undefined;
+}>;
+export type ResolvedMemoryCard = z.infer<typeof ResolvedMemoryCardSchema>;
+export declare const ResolvedMemoryCardsSchema: z.ZodObject<{
+    cards: z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        name: z.ZodString;
+        scope: z.ZodEnum<["user", "organization"]>;
+        createdBy: z.ZodString;
+        datasetId: z.ZodOptional<z.ZodString>;
+        description: z.ZodOptional<z.ZodString>;
+        cogneeUrl: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        name: string;
+        id: string;
+        scope: "user" | "organization";
+        createdBy: string;
+        cogneeUrl: string;
+        description?: string | undefined;
+        datasetId?: string | undefined;
+    }, {
+        name: string;
+        id: string;
+        scope: "user" | "organization";
+        createdBy: string;
+        cogneeUrl: string;
+        description?: string | undefined;
+        datasetId?: string | undefined;
+    }>, "many">;
+}, "strip", z.ZodTypeAny, {
+    cards: {
+        name: string;
+        id: string;
+        scope: "user" | "organization";
+        createdBy: string;
+        cogneeUrl: string;
+        description?: string | undefined;
+        datasetId?: string | undefined;
+    }[];
+}, {
+    cards: {
+        name: string;
+        id: string;
+        scope: "user" | "organization";
+        createdBy: string;
+        cogneeUrl: string;
+        description?: string | undefined;
+        datasetId?: string | undefined;
+    }[];
+}>;
+export declare const ResolvedCapabilitiesSchema: z.ZodObject<{
+    integrations: z.ZodOptional<z.ZodObject<{
+        tools: z.ZodArray<z.ZodRecord<z.ZodString, z.ZodUnknown>, "many">;
+    }, "strip", z.ZodTypeAny, {
+        tools: Record<string, unknown>[];
+    }, {
+        tools: Record<string, unknown>[];
+    }>>;
+    collections: z.ZodOptional<z.ZodObject<{
+        items: z.ZodArray<z.ZodObject<{
+            collectionId: z.ZodString;
+            access: z.ZodArray<z.ZodEnum<["list", "read", "create", "update", "delete"]>, "many">;
+        }, "strip", z.ZodTypeAny, {
+            collectionId: string;
+            access: ("create" | "list" | "read" | "update" | "delete")[];
+        }, {
+            collectionId: string;
+            access: ("create" | "list" | "read" | "update" | "delete")[];
+        }>, "many">;
+    }, "strip", z.ZodTypeAny, {
+        items: {
+            collectionId: string;
+            access: ("create" | "list" | "read" | "update" | "delete")[];
+        }[];
+    }, {
+        items: {
+            collectionId: string;
+            access: ("create" | "list" | "read" | "update" | "delete")[];
+        }[];
+    }>>;
+    contextFiles: z.ZodOptional<z.ZodObject<{
+        files: z.ZodArray<z.ZodObject<{
+            id: z.ZodString;
+            name: z.ZodString;
+            gsUrl: z.ZodString;
+        }, "strip", z.ZodTypeAny, {
+            name: string;
+            id: string;
+            gsUrl: string;
+        }, {
+            name: string;
+            id: string;
+            gsUrl: string;
+        }>, "many">;
+    }, "strip", z.ZodTypeAny, {
+        files: {
+            name: string;
+            id: string;
+            gsUrl: string;
+        }[];
+    }, {
+        files: {
+            name: string;
+            id: string;
+            gsUrl: string;
+        }[];
+    }>>;
+    memoryCards: z.ZodOptional<z.ZodObject<{
+        cards: z.ZodArray<z.ZodObject<{
+            id: z.ZodString;
+            name: z.ZodString;
+            scope: z.ZodEnum<["user", "organization"]>;
+            createdBy: z.ZodString;
+            datasetId: z.ZodOptional<z.ZodString>;
+            description: z.ZodOptional<z.ZodString>;
+            cogneeUrl: z.ZodString;
+        }, "strip", z.ZodTypeAny, {
+            name: string;
+            id: string;
+            scope: "user" | "organization";
+            createdBy: string;
+            cogneeUrl: string;
+            description?: string | undefined;
+            datasetId?: string | undefined;
+        }, {
+            name: string;
+            id: string;
+            scope: "user" | "organization";
+            createdBy: string;
+            cogneeUrl: string;
+            description?: string | undefined;
+            datasetId?: string | undefined;
+        }>, "many">;
+    }, "strip", z.ZodTypeAny, {
+        cards: {
+            name: string;
+            id: string;
+            scope: "user" | "organization";
+            createdBy: string;
+            cogneeUrl: string;
+            description?: string | undefined;
+            datasetId?: string | undefined;
+        }[];
+    }, {
+        cards: {
+            name: string;
+            id: string;
+            scope: "user" | "organization";
+            createdBy: string;
+            cogneeUrl: string;
+            description?: string | undefined;
+            datasetId?: string | undefined;
+        }[];
+    }>>;
+}, "strip", z.ZodTypeAny, {
+    integrations?: {
+        tools: Record<string, unknown>[];
+    } | undefined;
+    collections?: {
+        items: {
+            collectionId: string;
+            access: ("create" | "list" | "read" | "update" | "delete")[];
+        }[];
+    } | undefined;
+    contextFiles?: {
+        files: {
+            name: string;
+            id: string;
+            gsUrl: string;
+        }[];
+    } | undefined;
+    memoryCards?: {
+        cards: {
+            name: string;
+            id: string;
+            scope: "user" | "organization";
+            createdBy: string;
+            cogneeUrl: string;
+            description?: string | undefined;
+            datasetId?: string | undefined;
+        }[];
+    } | undefined;
+}, {
+    integrations?: {
+        tools: Record<string, unknown>[];
+    } | undefined;
+    collections?: {
+        items: {
+            collectionId: string;
+            access: ("create" | "list" | "read" | "update" | "delete")[];
+        }[];
+    } | undefined;
+    contextFiles?: {
+        files: {
+            name: string;
+            id: string;
+            gsUrl: string;
+        }[];
+    } | undefined;
+    memoryCards?: {
+        cards: {
+            name: string;
+            id: string;
+            scope: "user" | "organization";
+            createdBy: string;
+            cogneeUrl: string;
+            description?: string | undefined;
+            datasetId?: string | undefined;
+        }[];
+    } | undefined;
+}>;
+export type ResolvedCapabilities = z.infer<typeof ResolvedCapabilitiesSchema>;

package/build/module/capabilities.js

@@ -0,0 +1,73 @@
+import { z } from 'zod';
+/**
+ * Capability types — these describe the tenant-scoped resources a task or
+ * plugin default can attach (integrations, collections, context files,
+ * memory cards) and the resolved metadata the orchestrator injects before
+ * the runtime executes.
+ */
+// ---------- Authoring shapes (what plugin/task carries) ----------
+export const ConnectedIntegrationSchema = z.object({
+    slug: z.string(),
+    connectionPath: z.string(),
+    name: z.string(),
+    logo: z.string().optional(),
+    status: z.string(),
+    useAllTools: z.boolean().optional(),
+    toolSlugs: z.array(z.string()).optional(),
+});
+export const CollectionAccessOpSchema = z.enum([
+    'list',
+    'read',
+    'create',
+    'update',
+    'delete',
+]);
+export const CollectionAccessSchema = z.object({
+    collectionId: z.string(),
+    access: z.array(CollectionAccessOpSchema),
+});
+export const ContextFileRefSchema = z.object({
+    id: z.string(),
+    name: z.string(),
+    size: z.number(),
+    type: z.string(),
+    gsUrl: z.string(),
+});
+// Memory card IDs are stored as Firestore document paths.
+export const MemoryCardRefSchema = z.string();
+// ---------- Resolved shapes (what the orchestrator injects) ----------
+export const ResolvedIntegrationToolsSchema = z.object({
+    tools: z.array(z.record(z.unknown())),
+});
+export const ResolvedCollectionsSchema = z.object({
+    items: z.array(z.object({
+        collectionId: z.string(),
+        access: z.array(CollectionAccessOpSchema),
+    })),
+});
+export const ResolvedContextFilesSchema = z.object({
+    files: z.array(z.object({
+        id: z.string(),
+        name: z.string(),
+        gsUrl: z.string(),
+    })),
+});
+export const ResolvedMemoryCardSchema = z.object({
+    id: z.string(),
+    name: z.string(),
+    scope: z.enum(['user', 'organization']),
+    createdBy: z.string(),
+    datasetId: z.string().optional(),
+    description: z.string().optional(),
+    cogneeUrl: z.string(),
+});
+export const ResolvedMemoryCardsSchema = z.object({
+    cards: z.array(ResolvedMemoryCardSchema),
+});
+export const ResolvedCapabilitiesSchema = z.object({
+    integrations: ResolvedIntegrationToolsSchema.optional(),
+    collections: ResolvedCollectionsSchema.optional(),
+    contextFiles: ResolvedContextFilesSchema.optional(),
+    memoryCards: ResolvedMemoryCardsSchema.optional(),
+});
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiY2FwYWJpbGl0aWVzLmpzIiwic291cmNlUm9vdCI6IiIsInNvdXJjZXMiOlsiLi4vLi4vc3JjL2NhcGFiaWxpdGllcy50cyJdLCJuYW1lcyI6W10sIm1hcHBpbmdzIjoiQUFBQSxPQUFPLEVBQUUsQ0FBQyxFQUFFLE1BQU0sS0FBSyxDQUFDO0FBRXhCOzs7OztHQUtHO0FBRUgsb0VBQW9FO0FBRXBFLE1BQU0sQ0FBQyxNQUFNLDBCQUEwQixHQUFHLENBQUMsQ0FBQyxNQUFNLENBQUM7SUFDakQsSUFBSSxFQUFFLENBQUMsQ0FBQyxNQUFNLEVBQUU7SUFDaEIsY0FBYyxFQUFFLENBQUMsQ0FBQyxNQUFNLEVBQUU7SUFDMUIsSUFBSSxFQUFFLENBQUMsQ0FBQyxNQUFNLEVBQUU7SUFDaEIsSUFBSSxFQUFFLENBQUMsQ0FBQyxNQUFNLEVBQUUsQ0FBQyxRQUFRLEVBQUU7SUFDM0IsTUFBTSxFQUFFLENBQUMsQ0FBQyxNQUFNLEVBQUU7SUFDbEIsV0FBVyxFQUFFLENBQUMsQ0FBQyxPQUFPLEVBQUUsQ0FBQyxRQUFRLEVBQUU7SUFDbkMsU0FBUyxFQUFFLENBQUMsQ0FBQyxLQUFLLENBQUMsQ0FBQyxDQUFDLE1BQU0sRUFBRSxDQUFDLENBQUMsUUFBUSxFQUFFO0NBQzFDLENBQUMsQ0FBQztBQUdILE1BQU0sQ0FBQyxNQUFNLHdCQUF3QixHQUFHLENBQUMsQ0FBQyxJQUFJLENBQUM7SUFDN0MsTUFBTTtJQUNOLE1BQU07SUFDTixRQUFRO0lBQ1IsUUFBUTtJQUNSLFFBQVE7Q0FDVCxDQUFDLENBQUM7QUFHSCxNQUFNLENBQUMsTUFBTSxzQkFBc0IsR0FBRyxDQUFDLENBQUMsTUFBTSxDQUFDO0lBQzdDLFlBQVksRUFBRSxDQUFDLENBQUMsTUFBTSxFQUFFO0lBQ3hCLE1BQU0sRUFBRSxDQUFDLENBQUMsS0FBSyxDQUFDLHdCQUF3QixDQUFDO0NBQzFDLENBQUMsQ0FBQztBQUdILE1BQU0sQ0FBQyxNQUFNLG9CQUFvQixHQUFHLENBQUMsQ0FBQyxNQUFNLENBQUM7SUFD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

package/build/module/index.d.ts

@@ -0,0 +1,4 @@
+export * from './capabilities';
+export * from './plugin';
+export * from './task';
+export * from './records';

package/build/module/index.js

@@ -0,0 +1,5 @@
+export * from './capabilities';
+export * from './plugin';
+export * from './task';
+export * from './records';
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiaW5kZXguanMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyIuLi8uLi9zcmMvaW5kZXgudHMiXSwibmFtZXMiOltdLCJtYXBwaW5ncyI6IkFBQUEsY0FBYyxnQkFBZ0IsQ0FBQztBQUMvQixjQUFjLFVBQVUsQ0FBQztBQUN6QixjQUFjLFFBQVEsQ0FBQztBQUN2QixjQUFjLFdBQVcsQ0FBQyJ9