@callsitehq/core 0.1.0

package/dist/index.d.ts

@@ -0,0 +1,64 @@
+type JsonPrimitive = string | number | boolean | null;
+type JsonValue = JsonPrimitive | JsonValue[] | {
+    [key: string]: JsonValue;
+};
+type JsonObject = {
+    [key: string]: JsonValue;
+};
+interface Schema<T> {
+    readonly description?: string;
+    readonly jsonSchema?: JsonObject;
+    readonly parse: (value: unknown) => T;
+}
+interface CapabilityContext {
+    readonly request: Request;
+}
+type CapabilityRun<Input, Output> = (input: Input, context: CapabilityContext) => Output | Promise<Output>;
+interface CapabilityDefinition<Input, Output> {
+    readonly id: string;
+    readonly intent: string;
+    readonly input: Schema<Input>;
+    readonly output: Schema<Output>;
+    readonly destructive?: boolean;
+    readonly examples?: readonly CapabilityExample<Input, Output>[];
+    readonly run: CapabilityRun<Input, Output>;
+}
+interface CapabilityExample<Input, Output> {
+    readonly input: Input;
+    readonly output?: Output;
+    readonly intent?: string;
+}
+interface Capability<Input = unknown, Output = unknown> extends CapabilityDefinition<Input, Output> {
+    readonly kind: "callsite.capability";
+}
+type AnyCapability = Capability<any, any>;
+interface CapabilityIR {
+    readonly version: 1;
+    readonly capabilities: readonly CapabilityIRNode[];
+}
+interface CapabilityIRNode {
+    readonly id: string;
+    readonly intent: string;
+    readonly inputSchema: JsonObject;
+    readonly outputSchema: JsonObject;
+    readonly destructive: boolean;
+    readonly examples: readonly CapabilityIRExample[];
+}
+interface CapabilityIRExample {
+    readonly input: JsonValue;
+    readonly output?: JsonValue;
+    readonly intent?: string;
+}
+declare class CapabilityError extends Error {
+    readonly code: CapabilityErrorCode;
+    readonly details: JsonValue | undefined;
+    constructor(code: CapabilityErrorCode, message: string, options?: CapabilityErrorOptions);
+}
+type CapabilityErrorCode = "bad_request" | "unauthorized" | "forbidden" | "not_found" | "conflict" | "rate_limited" | "internal";
+interface CapabilityErrorOptions {
+    readonly details?: JsonValue;
+}
+declare function capability<Input, Output>(definition: CapabilityDefinition<Input, Output>): Capability<Input, Output>;
+declare function defineCallsite(capabilities: readonly AnyCapability[]): CapabilityIR;
+
+export { type AnyCapability, type Capability, type CapabilityContext, type CapabilityDefinition, CapabilityError, type CapabilityErrorCode, type CapabilityErrorOptions, type CapabilityExample, type CapabilityIR, type CapabilityIRExample, type CapabilityIRNode, type CapabilityRun, type JsonObject, type JsonPrimitive, type JsonValue, type Schema, capability, defineCallsite };

package/dist/index.js

@@ -0,0 +1,49 @@
+// src/index.ts
+var CapabilityError = class extends Error {
+  code;
+  details;
+  constructor(code, message, options = {}) {
+    super(message);
+    this.name = "CapabilityError";
+    this.code = code;
+    this.details = options.details;
+  }
+};
+function capability(definition) {
+  assertCapabilityId(definition.id);
+  return {
+    ...definition,
+    kind: "callsite.capability"
+  };
+}
+function defineCallsite(capabilities) {
+  return {
+    version: 1,
+    capabilities: capabilities.map(toIRNode)
+  };
+}
+function toIRNode(capabilityDefinition) {
+  return {
+    id: capabilityDefinition.id,
+    intent: capabilityDefinition.intent,
+    inputSchema: capabilityDefinition.input.jsonSchema ?? {},
+    outputSchema: capabilityDefinition.output.jsonSchema ?? {},
+    destructive: capabilityDefinition.destructive ?? false,
+    examples: (capabilityDefinition.examples ?? []).map((example) => ({
+      input: example.input,
+      ...example.output === void 0 ? {} : { output: example.output },
+      ...example.intent === void 0 ? {} : { intent: example.intent }
+    }))
+  };
+}
+function assertCapabilityId(id) {
+  if (!/^[a-z][a-z0-9_]*(\.[a-z][a-z0-9_]*)*$/.test(id)) {
+    throw new TypeError(`Invalid capability id "${id}". Use lowercase dot-separated identifiers.`);
+  }
+}
+export {
+  CapabilityError,
+  capability,
+  defineCallsite
+};
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/index.ts"],"sourcesContent":["export type JsonPrimitive = string | number | boolean | null;\nexport type JsonValue = JsonPrimitive | JsonValue[] | { [key: string]: JsonValue };\nexport type JsonObject = { [key: string]: JsonValue };\n\nexport interface Schema<T> {\n  readonly description?: string;\n  readonly jsonSchema?: JsonObject;\n  readonly parse: (value: unknown) => T;\n}\n\nexport interface CapabilityContext {\n  readonly request: Request;\n}\n\nexport type CapabilityRun<Input, Output> = (\n  input: Input,\n  context: CapabilityContext\n) => Output | Promise<Output>;\n\nexport interface CapabilityDefinition<Input, Output> {\n  readonly id: string;\n  readonly intent: string;\n  readonly input: Schema<Input>;\n  readonly output: Schema<Output>;\n  readonly destructive?: boolean;\n  readonly examples?: readonly CapabilityExample<Input, Output>[];\n  readonly run: CapabilityRun<Input, Output>;\n}\n\nexport interface CapabilityExample<Input, Output> {\n  readonly input: Input;\n  readonly output?: Output;\n  readonly intent?: string;\n}\n\nexport interface Capability<Input = unknown, Output = unknown> extends CapabilityDefinition<\n  Input,\n  Output\n> {\n  readonly kind: \"callsite.capability\";\n}\n\nexport type AnyCapability = Capability<any, any>;\n\nexport interface CapabilityIR {\n  readonly version: 1;\n  readonly capabilities: readonly CapabilityIRNode[];\n}\n\nexport interface CapabilityIRNode {\n  readonly id: string;\n  readonly intent: string;\n  readonly inputSchema: JsonObject;\n  readonly outputSchema: JsonObject;\n  readonly destructive: boolean;\n  readonly examples: readonly CapabilityIRExample[];\n}\n\nexport interface CapabilityIRExample {\n  readonly input: JsonValue;\n  readonly output?: JsonValue;\n  readonly intent?: string;\n}\n\nexport class CapabilityError extends Error {\n  public readonly code: CapabilityErrorCode;\n  public readonly details: JsonValue | undefined;\n\n  public constructor(\n    code: CapabilityErrorCode,\n    message: string,\n    options: CapabilityErrorOptions = {}\n  ) {\n    super(message);\n    this.name = \"CapabilityError\";\n    this.code = code;\n    this.details = options.details;\n  }\n}\n\nexport type CapabilityErrorCode =\n  | \"bad_request\"\n  | \"unauthorized\"\n  | \"forbidden\"\n  | \"not_found\"\n  | \"conflict\"\n  | \"rate_limited\"\n  | \"internal\";\n\nexport interface CapabilityErrorOptions {\n  readonly details?: JsonValue;\n}\n\nexport function capability<Input, Output>(\n  definition: CapabilityDefinition<Input, Output>\n): Capability<Input, Output> {\n  assertCapabilityId(definition.id);\n\n  return {\n    ...definition,\n    kind: \"callsite.capability\"\n  };\n}\n\nexport function defineCallsite(capabilities: readonly AnyCapability[]): CapabilityIR {\n  return {\n    version: 1,\n    capabilities: capabilities.map(toIRNode)\n  };\n}\n\nfunction toIRNode(capabilityDefinition: AnyCapability): CapabilityIRNode {\n  return {\n    id: capabilityDefinition.id,\n    intent: capabilityDefinition.intent,\n    inputSchema: capabilityDefinition.input.jsonSchema ?? {},\n    outputSchema: capabilityDefinition.output.jsonSchema ?? {},\n    destructive: capabilityDefinition.destructive ?? false,\n    examples: (capabilityDefinition.examples ?? []).map((example) => ({\n      input: example.input,\n      ...(example.output === undefined ? {} : { output: example.output }),\n      ...(example.intent === undefined ? {} : { intent: example.intent })\n    }))\n  };\n}\n\nfunction assertCapabilityId(id: string): void {\n  if (!/^[a-z][a-z0-9_]*(\\.[a-z][a-z0-9_]*)*$/.test(id)) {\n    throw new TypeError(`Invalid capability id \"${id}\". Use lowercase dot-separated identifiers.`);\n  }\n}\n"],"mappings":";AAgEO,IAAM,kBAAN,cAA8B,MAAM;AAAA,EACzB;AAAA,EACA;AAAA,EAET,YACL,MACA,SACA,UAAkC,CAAC,GACnC;AACA,UAAM,OAAO;AACb,SAAK,OAAO;AACZ,SAAK,OAAO;AACZ,SAAK,UAAU,QAAQ;AAAA,EACzB;AACF;AAeO,SAAS,WACd,YAC2B;AAC3B,qBAAmB,WAAW,EAAE;AAEhC,SAAO;AAAA,IACL,GAAG;AAAA,IACH,MAAM;AAAA,EACR;AACF;AAEO,SAAS,eAAe,cAAsD;AACnF,SAAO;AAAA,IACL,SAAS;AAAA,IACT,cAAc,aAAa,IAAI,QAAQ;AAAA,EACzC;AACF;AAEA,SAAS,SAAS,sBAAuD;AACvE,SAAO;AAAA,IACL,IAAI,qBAAqB;AAAA,IACzB,QAAQ,qBAAqB;AAAA,IAC7B,aAAa,qBAAqB,MAAM,cAAc,CAAC;AAAA,IACvD,cAAc,qBAAqB,OAAO,cAAc,CAAC;AAAA,IACzD,aAAa,qBAAqB,eAAe;AAAA,IACjD,WAAW,qBAAqB,YAAY,CAAC,GAAG,IAAI,CAAC,aAAa;AAAA,MAChE,OAAO,QAAQ;AAAA,MACf,GAAI,QAAQ,WAAW,SAAY,CAAC,IAAI,EAAE,QAAQ,QAAQ,OAAO;AAAA,MACjE,GAAI,QAAQ,WAAW,SAAY,CAAC,IAAI,EAAE,QAAQ,QAAQ,OAAO;AAAA,IACnE,EAAE;AAAA,EACJ;AACF;AAEA,SAAS,mBAAmB,IAAkB;AAC5C,MAAI,CAAC,wCAAwC,KAAK,EAAE,GAAG;AACrD,UAAM,IAAI,UAAU,0BAA0B,EAAE,6CAA6C;AAAA,EAC/F;AACF;","names":[]}

package/package.json

@@ -0,0 +1,21 @@
+{
+  "name": "@callsitehq/core",
+  "version": "0.1.0",
+  "description": "Authoring API and IR types for Callsite capabilities.",
+  "type": "module",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "sideEffects": false,
+  "scripts": {
+    "build": "tsup",
+    "clean": "rm -rf dist *.tsbuildinfo",
+    "typecheck": "tsc -p tsconfig.json --noEmit"
+  }
+}