@lineai/agent-platform-types 0.1.0

package/build/module/plugin.js

@@ -0,0 +1,122 @@
+import { z } from 'zod';
+import { CollectionAccessSchema, ConnectedIntegrationSchema, ContextFileRefSchema, MemoryCardRefSchema, } from './capabilities';
+/**
+ * Plugin schemas — these mirror the documents stored in Firestore at:
+ *   organizations/{orgId}/projects/{projectId}/services/agent-platform/plugin/{section}
+ *
+ * Sections: defaults, skills, agents (subagents), mcp-servers, hooks.
+ *
+ * The line-ai console authors these documents; the agent-platform orchestrator
+ * loads them at task submission time and merges them into the resolved task
+ * definition that the runtime executes.
+ */
+// ---------- API capabilities (mirror of runtime CapabilitiesSchema) ----------
+export const PluginCapabilitiesSchema = z.object({
+    promptCaching: z.boolean().optional(),
+    extendedThinking: z
+        .object({
+        enabled: z.boolean(),
+        budgetTokens: z.number().min(1024),
+    })
+        .optional(),
+    extendedContext: z.boolean().optional(),
+    memory: z
+        .object({
+        enabled: z.boolean(),
+        backend: z.enum(['gcs', 'local']).default('gcs'),
+        directory: z.string().optional(),
+    })
+        .optional(),
+});
+// ---------- Defaults section ----------
+export const PluginDefaultsSchema = z.object({
+    // Execution
+    model: z.string().optional(),
+    maxTurns: z.number().min(1).max(500).optional(),
+    timeoutSeconds: z.number().min(60).max(86400).optional(),
+    workingDir: z.string().optional(),
+    // System prompt
+    systemPromptRef: z.string().optional(),
+    persona: z.string().optional(),
+    constraints: z.array(z.string()).optional(),
+    // Tools
+    allowedTools: z.array(z.string()).optional(),
+    disabledTools: z.array(z.string()).optional(),
+    // SDK features
+    capabilities: PluginCapabilitiesSchema.optional(),
+    betas: z.array(z.string()).optional(),
+    // Capability resources (replaced — not merged — when task supplies its own)
+    integrations: z.array(ConnectedIntegrationSchema).optional(),
+    collections: z.array(CollectionAccessSchema).optional(),
+    contextFiles: z.array(ContextFileRefSchema).optional(),
+    memoryCards: z.array(MemoryCardRefSchema).optional(),
+});
+// ---------- Skills section ----------
+export const SkillSchema = z.object({
+    id: z.string(),
+    name: z.string(),
+    description: z.string(),
+    body: z.string(),
+    allowedTools: z.array(z.string()).optional(),
+});
+export const PluginSkillsSchema = z.object({
+    items: z.array(SkillSchema).default([]),
+});
+// ---------- Subagents section ----------
+export const SubagentModelChoiceSchema = z.enum([
+    'inherit',
+    'haiku',
+    'sonnet',
+    'opus',
+]);
+export const PluginSubagentSchema = z.object({
+    id: z.string(),
+    name: z.string(),
+    description: z.string(),
+    prompt: z.string(),
+    tools: z.array(z.string()).optional(),
+    model: SubagentModelChoiceSchema.optional(),
+    // Skill IDs the subagent should have access to (resolved via .claude/skills/).
+    skills: z.array(z.string()).optional(),
+    // MCP server names (keys in the merged mcpServers catalog).
+    mcpServers: z.array(z.string()).optional(),
+});
+export const PluginAgentsSchema = z.object({
+    items: z.array(PluginSubagentSchema).default([]),
+});
+// ---------- MCP servers section ----------
+export const PluginMcpServerEntrySchema = z.object({
+    type: z.literal('http'),
+    url: z.string().url(),
+    headers: z.record(z.string()).optional(),
+});
+export const PluginMcpServersSchema = z.object({
+    servers: z.record(PluginMcpServerEntrySchema).default({}),
+});
+// ---------- Hooks section (read-only, deferred) ----------
+export const PluginHookSchema = z.object({
+    id: z.string(),
+    name: z.string(),
+    description: z.string(),
+    event: z.string(),
+});
+export const PluginHooksSchema = z.object({
+    items: z.array(PluginHookSchema).default([]),
+});
+// ---------- Full plugin snapshot ----------
+export const PluginSnapshotSchema = z.object({
+    defaults: PluginDefaultsSchema.nullable().optional(),
+    skills: PluginSkillsSchema.nullable().optional(),
+    agents: PluginAgentsSchema.nullable().optional(),
+    'mcp-servers': PluginMcpServersSchema.nullable().optional(),
+    hooks: PluginHooksSchema.nullable().optional(),
+});
+/** The Firestore section keys, in load order. */
+export const PLUGIN_SECTIONS = [
+    'defaults',
+    'skills',
+    'agents',
+    'mcp-servers',
+    'hooks',
+];
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoicGx1Z2luLmpzIiwic291cmNlUm9vdCI6IiIsInNvdXJjZXMiOlsiLi4vLi4vc3JjL3BsdWdpbi50cyJdLCJuYW1lcyI6W10sIm1hcHBpbmdzIjoiQUFBQSxPQUFPLEVBQUUsQ0FBQyxFQUFFLE1BQU0sS0FBSyxDQUFDO0FBQ3hCLE9BQU8sRUFDTCxzQkFBc0IsRUFDdEIsMEJBQTBCLEVBQzFCLG9CQUFvQixFQUNwQixtQkFBbUIsR0FDcEIsTUFBTSxnQkFBZ0IsQ0FBQztBQUV4Qjs7Ozs7Ozs7O0dBU0c7QUFFSCxnRkFBZ0Y7QUFFaEYsTUFBTSxDQUFDLE1BQU0sd0JBQXdCLEdBQUcsQ0FBQyxDQUFDLE1BQU0sQ0FBQztJQUMvQyxhQUFhLEVBQUUsQ0FBQyxDQUFDLE9BQU8sRUFBRSxDQUFDLFFBQVEsRUFBRTtJQUNyQyxnQkFBZ0IsRUFBRSxDQUFDO1NBQ2hCLE1BQU0sQ0FBQztRQUNOLE9BQU8sRUFBRSxDQUFDLENBQUMsT0FBTyxFQUFFO1FBQ3BCLFlBQVksRUFBRSxDQUFDLENBQUMsTUFBTSxFQUFFLENBQUMsR0FBRyxDQUFDLElBQUksQ0FBQztLQUNuQyxDQUFDO1NBQ0QsUUFBUSxFQUFFO0lBQ2IsZUFBZSxFQUFFLENBQUMsQ0FBQyxPQUFPLEVBQUUsQ0FBQyxRQUFRLEVBQUU7SUFDdkMsTUFBTSxFQUFFLENBQUM7U0FDTixNQUFNLENBQUM7UUFDTixPQUFPLEVBQUUsQ0FBQyxDQUFDLE9BQU8sRUFBRTtRQUNwQixPQUFPLEVBQUUsQ0FBQyxDQUFDLElBQUksQ0FBQyxDQUFDLEtBQUssRUFBRSxPQUFPLENBQUMsQ0FBQyxDQUFDLE9BQU8sQ0FBQyxLQUFLLENBQUM7UUFDaEQsU0FBUyxFQUFFLENBQUMsQ0FBQyxNQUFNLEVBQUUsQ0FBQyxRQUFRLEVBQUU7S0FDakMsQ0FBQztTQUNELFFBQVEsRUFBRTtDQUNkLENBQUMsQ0FBQztBQUdILHlDQUF5QztBQUV6QyxNQUFNLENBQUMsTUFBTSxvQkFBb0IsR0FBRyxDQUFDLENBQUMsTUFBTSxDQUFDO0lBQzND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