63 lines · 2 KBtext/plain; charset=utf-8
The Coline App SDK: apps, tools, file types and surfaces that run inside Coline workspaces, and public websites with Coline Sites. TypeScript, with an in-memory test workspace. MIT.
| 4 | import type { |
| 5 | AnyColineToolDefinitionV2, |
| 6 | ColineAppConfigV2, |
| 7 | } from "./types"; |
| 8 |
| 9 | /** |
| 10 | * The extraction step of the two-artifact model (plan §6.1). |
| 11 | * |
| 12 | * From one definition source, extraction produces the serializable |
| 13 | * manifest artifact — names, schemas, effects, permissions, surfaces — |
| 14 | * while the executable implementations stay behind in the runtime |
| 15 | * artifact. Extraction is deterministic: no IO, no clocks, no randomness; |
| 16 | * the platform re-runs it at publish time and rejects on mismatch. |
| 17 | */ |
| 18 |
| 19 | export function extractToolMetadata(tool: AnyColineToolDefinitionV2): AppToolMetadata { |
| 20 | const inputSchema = z.toJSONSchema(tool.input, { unrepresentable: "throw" }); |
| 21 | return { |
| 22 | name: tool.name, |
| 23 | description: tool.description, |
| 24 | inputSchema: inputSchema as Record<string, unknown>, |
| 25 | effect: tool.effect, |
| 26 | }; |
| 27 | } |
| 28 |
| 29 | function isCommandDefinition( |
| 30 | command: ColineAppConfigV2["commands"] extends Array<infer T> | undefined ? T : never, |
| 31 | ): command is Extract<typeof command, { kind: "command" }> { |
| 32 | return "kind" in command && command.kind === "command"; |
| 33 | } |
| 34 |
| 35 | export function extractManifestInput(config: ColineAppConfigV2): ColineAppManifestV2Input { |
| 36 | const { files, tools, commands, handlers, endpoints, jobs, collections, ...rest } = config; |
| 37 | void handlers; |
| 38 |
| 39 | return { |
| 40 | ...rest, |
| 41 | // A collection's zod schema travels as JSON Schema, which Coline checks visitor writes against. |
| 42 | ...(collections |
| 43 | ? { |
| 44 | collections: Object.fromEntries( |
| 45 | Object.entries(collections).map(([name, { schema, ...declaration }]) => [ |
| 46 | name, |
| 47 | schema |
| 48 | ? { ...declaration, schema: z.toJSONSchema(schema, { unrepresentable: "throw" }) as Record<string, unknown> } |
| 49 | : declaration, |
| 50 | ]), |
| 51 | ), |
| 52 | } |
| 53 | : {}), |
| 54 | files: (files ?? []).map((fileType) => fileType.metadata), |
| 55 | tools: (tools ?? []).map(extractToolMetadata), |
| 56 | commands: (commands ?? []).map((command) => |
| 57 | isCommandDefinition(command) ? command.command : command, |
| 58 | ), |
| 59 | endpoints: (endpoints ?? []).map((endpoint) => endpoint.metadata), |
| 60 | jobs: (jobs ?? []).map((job) => job.metadata), |
| 61 | }; |
| 62 | } |
| 63 |