@callsitehq/core 0.1.0 → 0.2.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Callsite contributors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,17 @@
+# @callsitehq/core
+
+Core authoring primitives for Callsite.
+
+Use this package to define intent-level capabilities and build the intermediate
+representation that Callsite renderers and runtimes consume.
+Capabilities may also declare expected semantic errors; those errors become
+part of the IR alongside input/output schemas.
+
+```ts
+import { capability, toIR } from "@callsitehq/core";
+```
+
+## Status
+
+Early `0.x` package. APIs may change while the capability definition model is
+being finalized.

package/dist/index.d.ts

@@ -1,64 +1,114 @@
 type JsonPrimitive = string | number | boolean | null;
-type JsonValue = JsonPrimitive | JsonValue[] | {
-    [key: string]: JsonValue;
+type JsonValue = JsonPrimitive | readonly JsonValue[] | {
+    readonly [key: string]: JsonValue;
 };
 type JsonObject = {
-    [key: string]: JsonValue;
+    readonly [key: string]: JsonValue;
 };
-interface Schema<T> {
-    readonly description?: string;
-    readonly jsonSchema?: JsonObject;
-    readonly parse: (value: unknown) => T;
+type JsonSchema = JsonObject;
+interface StandardSchemaV1<Input = unknown, Output = Input> {
+    readonly "~standard": {
+        readonly version: 1;
+        readonly vendor: string;
+        readonly validate: (value: unknown, options?: StandardSchemaOptions | undefined) => StandardResult<Output> | Promise<StandardResult<Output>>;
+        readonly types?: {
+            readonly input: Input;
+            readonly output: Output;
+        } | undefined;
+    };
 }
+interface StandardSchemaOptions {
+    readonly libraryOptions?: Record<string, unknown> | undefined;
+}
+type StandardResult<Output> = {
+    readonly value: Output;
+    readonly issues?: undefined;
+} | {
+    readonly issues: readonly StandardIssue[];
+};
+interface StandardIssue {
+    readonly message: string;
+    readonly path?: readonly (PropertyKey | StandardPathSegment)[] | undefined;
+}
+interface StandardPathSegment {
+    readonly key: PropertyKey;
+}
+type Infer<Schema extends StandardSchemaV1> = NonNullable<Schema["~standard"]["types"]>["output"];
+type InferInput<Schema extends StandardSchemaV1> = NonNullable<Schema["~standard"]["types"]>["input"];
+type JsonSchemaDirection = "input" | "output";
+interface ToJsonSchemaOptions {
+    readonly direction: JsonSchemaDirection;
+}
+type ToJsonSchema = (schema: StandardSchemaV1, options: ToJsonSchemaOptions) => JsonSchema;
+type CapabilityErrorCode = "invalid_input" | "not_found" | "unauthorized" | "forbidden" | "conflict" | "rate_limited" | "unavailable" | "internal";
+type DeclaredCapabilityErrorCode = Exclude<CapabilityErrorCode, "invalid_input" | "internal">;
+interface CapabilityErrorSpec {
+    readonly code: DeclaredCapabilityErrorCode;
+    readonly intent: string;
+}
+declare class CapabilityError extends Error {
+    readonly code: CapabilityErrorCode;
+    readonly details?: JsonObject | undefined;
+    constructor(code: CapabilityErrorCode, message: string, details?: JsonObject | undefined);
+}
+type SurfaceName = "mcp" | "openapi" | "chatgpt" | "claude-connector";
 interface CapabilityContext {
-    readonly request: Request;
+    readonly subject?: unknown;
+    readonly log: (event: string, data?: Record<string, unknown>) => void;
+}
+type AnyStandardSchema = StandardSchemaV1<any, any>;
+type CapabilityRun<InputSchema extends AnyStandardSchema, OutputSchema extends AnyStandardSchema> = (input: Infer<InputSchema>, context: CapabilityContext) => InferInput<OutputSchema> | Promise<InferInput<OutputSchema>>;
+interface CapabilityExample<InputSchema extends AnyStandardSchema, OutputSchema extends AnyStandardSchema> {
+    readonly input: InferInput<InputSchema> & JsonValue;
+    readonly output: Infer<OutputSchema> & JsonValue;
+    readonly note?: string;
 }
-type CapabilityRun<Input, Output> = (input: Input, context: CapabilityContext) => Output | Promise<Output>;
-interface CapabilityDefinition<Input, Output> {
+type SurfaceExtensions = Partial<Record<SurfaceName, JsonObject>>;
+interface Capability<InputSchema extends AnyStandardSchema = AnyStandardSchema, OutputSchema extends AnyStandardSchema = AnyStandardSchema> {
     readonly id: string;
     readonly intent: string;
-    readonly input: Schema<Input>;
-    readonly output: Schema<Output>;
+    readonly input: InputSchema;
+    readonly output: OutputSchema;
     readonly destructive?: boolean;
-    readonly examples?: readonly CapabilityExample<Input, Output>[];
-    readonly run: CapabilityRun<Input, Output>;
+    readonly errors?: readonly CapabilityErrorSpec[];
+    readonly examples?: readonly CapabilityExample<InputSchema, OutputSchema>[];
+    readonly run: CapabilityRun<InputSchema, OutputSchema>;
+    readonly overrides?: SurfaceExtensions;
+    readonly passthrough?: SurfaceExtensions;
 }
-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";
+interface AnyCapability {
+    readonly id: string;
+    readonly intent: string;
+    readonly input: AnyStandardSchema;
+    readonly output: AnyStandardSchema;
+    readonly destructive?: boolean;
+    readonly errors?: readonly CapabilityErrorSpec[];
+    readonly examples?: readonly CapabilityIRExample[];
+    readonly run: (input: any, context: CapabilityContext) => any;
+    readonly overrides?: SurfaceExtensions;
+    readonly passthrough?: SurfaceExtensions;
 }
-type AnyCapability = Capability<any, any>;
+declare function capability<InputSchema extends AnyStandardSchema, OutputSchema extends AnyStandardSchema>(definition: Capability<InputSchema, OutputSchema>): Capability<InputSchema, OutputSchema>;
 interface CapabilityIR {
-    readonly version: 1;
-    readonly capabilities: readonly CapabilityIRNode[];
-}
-interface CapabilityIRNode {
     readonly id: string;
     readonly intent: string;
-    readonly inputSchema: JsonObject;
-    readonly outputSchema: JsonObject;
+    readonly input: JsonSchema;
+    readonly output: JsonSchema;
     readonly destructive: boolean;
+    readonly errors: readonly CapabilityErrorSpec[];
     readonly examples: readonly CapabilityIRExample[];
+    readonly overrides: SurfaceExtensions;
+    readonly passthrough: SurfaceExtensions;
 }
 interface CapabilityIRExample {
     readonly input: JsonValue;
-    readonly output?: JsonValue;
-    readonly intent?: string;
+    readonly output: JsonValue;
+    readonly note?: 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;
+interface IR {
+    readonly version: 1;
+    readonly capabilities: readonly CapabilityIR[];
 }
-declare function capability<Input, Output>(definition: CapabilityDefinition<Input, Output>): Capability<Input, Output>;
-declare function defineCallsite(capabilities: readonly AnyCapability[]): CapabilityIR;
+declare function toIR(capabilities: readonly AnyCapability[], toJsonSchema: ToJsonSchema): IR;
 
-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 };
+export { type AnyCapability, type AnyStandardSchema, type Capability, type CapabilityContext, CapabilityError, type CapabilityErrorCode, type CapabilityErrorSpec, type CapabilityExample, type CapabilityIR, type CapabilityIRExample, type CapabilityRun, type DeclaredCapabilityErrorCode, type IR, type Infer, type InferInput, type JsonObject, type JsonPrimitive, type JsonSchema, type JsonSchemaDirection, type JsonValue, type StandardIssue, type StandardPathSegment, type StandardResult, type StandardSchemaOptions, type StandardSchemaV1, type SurfaceExtensions, type SurfaceName, type ToJsonSchema, type ToJsonSchemaOptions, capability, toIR };

package/dist/index.js

@@ -1,49 +1,48 @@
 // src/index.ts
 var CapabilityError = class extends Error {
-  code;
-  details;
-  constructor(code, message, options = {}) {
+  constructor(code, message, details) {
     super(message);
-    this.name = "CapabilityError";
     this.code = code;
-    this.details = options.details;
+    this.details = details;
+    this.name = "CapabilityError";
   }
+  code;
+  details;
 };
 function capability(definition) {
   assertCapabilityId(definition.id);
-  return {
-    ...definition,
-    kind: "callsite.capability"
-  };
+  return definition;
 }
-function defineCallsite(capabilities) {
+function toIR(capabilities, toJsonSchema) {
   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 }
+    capabilities: capabilities.map((capabilityDefinition) => ({
+      id: capabilityDefinition.id,
+      intent: capabilityDefinition.intent,
+      input: toJsonSchema(capabilityDefinition.input, { direction: "input" }),
+      output: toJsonSchema(capabilityDefinition.output, { direction: "output" }),
+      destructive: capabilityDefinition.destructive ?? false,
+      errors: capabilityDefinition.errors ?? [],
+      examples: (capabilityDefinition.examples ?? []).map((example) => ({
+        input: example.input,
+        output: example.output,
+        ...example.note === void 0 ? {} : { note: example.note }
+      })),
+      overrides: capabilityDefinition.overrides ?? {},
+      passthrough: capabilityDefinition.passthrough ?? {}
     }))
   };
 }
 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.`);
+    throw new TypeError(
+      `Invalid capability id "${id}". Use lowercase letters, digits, underscores, and dot-separated namespaces.`
+    );
   }
 }
 export {
   CapabilityError,
   capability,
-  defineCallsite
+  toIR
 };
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +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":[]}
+{"version":3,"sources":["../src/index.ts"],"sourcesContent":["export type JsonPrimitive = string | number | boolean | null;\nexport type JsonValue =\n  JsonPrimitive | readonly JsonValue[] | { readonly [key: string]: JsonValue };\nexport type JsonObject = { readonly [key: string]: JsonValue };\nexport type JsonSchema = JsonObject;\n\nexport interface StandardSchemaV1<Input = unknown, Output = Input> {\n  readonly \"~standard\": {\n    readonly version: 1;\n    readonly vendor: string;\n    readonly validate: (\n      value: unknown,\n      options?: StandardSchemaOptions | undefined\n    ) => StandardResult<Output> | Promise<StandardResult<Output>>;\n    readonly types?:\n      | {\n          readonly input: Input;\n          readonly output: Output;\n        }\n      | undefined;\n  };\n}\n\nexport interface StandardSchemaOptions {\n  readonly libraryOptions?: Record<string, unknown> | undefined;\n}\n\nexport type StandardResult<Output> =\n  | {\n      readonly value: Output;\n      readonly issues?: undefined;\n    }\n  | {\n      readonly issues: readonly StandardIssue[];\n    };\n\nexport interface StandardIssue {\n  readonly message: string;\n  readonly path?: readonly (PropertyKey | StandardPathSegment)[] | undefined;\n}\n\nexport interface StandardPathSegment {\n  readonly key: PropertyKey;\n}\n\nexport type Infer<Schema extends StandardSchemaV1> = NonNullable<\n  Schema[\"~standard\"][\"types\"]\n>[\"output\"];\n\nexport type InferInput<Schema extends StandardSchemaV1> = NonNullable<\n  Schema[\"~standard\"][\"types\"]\n>[\"input\"];\n\nexport type JsonSchemaDirection = \"input\" | \"output\";\n\nexport interface ToJsonSchemaOptions {\n  readonly direction: JsonSchemaDirection;\n}\n\nexport type ToJsonSchema = (schema: StandardSchemaV1, options: ToJsonSchemaOptions) => JsonSchema;\n\nexport type CapabilityErrorCode =\n  | \"invalid_input\"\n  | \"not_found\"\n  | \"unauthorized\"\n  | \"forbidden\"\n  | \"conflict\"\n  | \"rate_limited\"\n  | \"unavailable\"\n  | \"internal\";\n\nexport type DeclaredCapabilityErrorCode = Exclude<\n  CapabilityErrorCode,\n  \"invalid_input\" | \"internal\"\n>;\n\nexport interface CapabilityErrorSpec {\n  readonly code: DeclaredCapabilityErrorCode;\n  readonly intent: string;\n}\n\nexport class CapabilityError extends Error {\n  public constructor(\n    public readonly code: CapabilityErrorCode,\n    message: string,\n    public readonly details?: JsonObject\n  ) {\n    super(message);\n    this.name = \"CapabilityError\";\n  }\n}\n\nexport type SurfaceName = \"mcp\" | \"openapi\" | \"chatgpt\" | \"claude-connector\";\n\nexport interface CapabilityContext {\n  readonly subject?: unknown;\n  readonly log: (event: string, data?: Record<string, unknown>) => void;\n}\n\nexport type AnyStandardSchema = StandardSchemaV1<any, any>;\n\nexport type CapabilityRun<\n  InputSchema extends AnyStandardSchema,\n  OutputSchema extends AnyStandardSchema\n> = (\n  input: Infer<InputSchema>,\n  context: CapabilityContext\n) => InferInput<OutputSchema> | Promise<InferInput<OutputSchema>>;\n\nexport interface CapabilityExample<\n  InputSchema extends AnyStandardSchema,\n  OutputSchema extends AnyStandardSchema\n> {\n  readonly input: InferInput<InputSchema> & JsonValue;\n  readonly output: Infer<OutputSchema> & JsonValue;\n  readonly note?: string;\n}\n\nexport type SurfaceExtensions = Partial<Record<SurfaceName, JsonObject>>;\n\nexport interface Capability<\n  InputSchema extends AnyStandardSchema = AnyStandardSchema,\n  OutputSchema extends AnyStandardSchema = AnyStandardSchema\n> {\n  readonly id: string;\n  readonly intent: string;\n  readonly input: InputSchema;\n  readonly output: OutputSchema;\n  readonly destructive?: boolean;\n  readonly errors?: readonly CapabilityErrorSpec[];\n  readonly examples?: readonly CapabilityExample<InputSchema, OutputSchema>[];\n  readonly run: CapabilityRun<InputSchema, OutputSchema>;\n  readonly overrides?: SurfaceExtensions;\n  readonly passthrough?: SurfaceExtensions;\n}\n\nexport interface AnyCapability {\n  readonly id: string;\n  readonly intent: string;\n  readonly input: AnyStandardSchema;\n  readonly output: AnyStandardSchema;\n  readonly destructive?: boolean;\n  readonly errors?: readonly CapabilityErrorSpec[];\n  readonly examples?: readonly CapabilityIRExample[];\n  readonly run: (input: any, context: CapabilityContext) => any;\n  readonly overrides?: SurfaceExtensions;\n  readonly passthrough?: SurfaceExtensions;\n}\n\nexport function capability<\n  InputSchema extends AnyStandardSchema,\n  OutputSchema extends AnyStandardSchema\n>(definition: Capability<InputSchema, OutputSchema>): Capability<InputSchema, OutputSchema> {\n  assertCapabilityId(definition.id);\n\n  return definition;\n}\n\nexport interface CapabilityIR {\n  readonly id: string;\n  readonly intent: string;\n  readonly input: JsonSchema;\n  readonly output: JsonSchema;\n  readonly destructive: boolean;\n  readonly errors: readonly CapabilityErrorSpec[];\n  readonly examples: readonly CapabilityIRExample[];\n  readonly overrides: SurfaceExtensions;\n  readonly passthrough: SurfaceExtensions;\n}\n\nexport interface CapabilityIRExample {\n  readonly input: JsonValue;\n  readonly output: JsonValue;\n  readonly note?: string;\n}\n\nexport interface IR {\n  readonly version: 1;\n  readonly capabilities: readonly CapabilityIR[];\n}\n\nexport function toIR(capabilities: readonly AnyCapability[], toJsonSchema: ToJsonSchema): IR {\n  return {\n    version: 1,\n    capabilities: capabilities.map((capabilityDefinition) => ({\n      id: capabilityDefinition.id,\n      intent: capabilityDefinition.intent,\n      input: toJsonSchema(capabilityDefinition.input, { direction: \"input\" }),\n      output: toJsonSchema(capabilityDefinition.output, { direction: \"output\" }),\n      destructive: capabilityDefinition.destructive ?? false,\n      errors: capabilityDefinition.errors ?? [],\n      examples: (capabilityDefinition.examples ?? []).map((example) => ({\n        input: example.input,\n        output: example.output,\n        ...(example.note === undefined ? {} : { note: example.note })\n      })),\n      overrides: capabilityDefinition.overrides ?? {},\n      passthrough: capabilityDefinition.passthrough ?? {}\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(\n      `Invalid capability id \"${id}\". Use lowercase letters, digits, underscores, and dot-separated namespaces.`\n    );\n  }\n}\n"],"mappings":";AAiFO,IAAM,kBAAN,cAA8B,MAAM;AAAA,EAClC,YACW,MAChB,SACgB,SAChB;AACA,UAAM,OAAO;AAJG;AAEA;AAGhB,SAAK,OAAO;AAAA,EACd;AAAA,EANkB;AAAA,EAEA;AAKpB;AA2DO,SAAS,WAGd,YAA0F;AAC1F,qBAAmB,WAAW,EAAE;AAEhC,SAAO;AACT;AAyBO,SAAS,KAAK,cAAwC,cAAgC;AAC3F,SAAO;AAAA,IACL,SAAS;AAAA,IACT,cAAc,aAAa,IAAI,CAAC,0BAA0B;AAAA,MACxD,IAAI,qBAAqB;AAAA,MACzB,QAAQ,qBAAqB;AAAA,MAC7B,OAAO,aAAa,qBAAqB,OAAO,EAAE,WAAW,QAAQ,CAAC;AAAA,MACtE,QAAQ,aAAa,qBAAqB,QAAQ,EAAE,WAAW,SAAS,CAAC;AAAA,MACzE,aAAa,qBAAqB,eAAe;AAAA,MACjD,QAAQ,qBAAqB,UAAU,CAAC;AAAA,MACxC,WAAW,qBAAqB,YAAY,CAAC,GAAG,IAAI,CAAC,aAAa;AAAA,QAChE,OAAO,QAAQ;AAAA,QACf,QAAQ,QAAQ;AAAA,QAChB,GAAI,QAAQ,SAAS,SAAY,CAAC,IAAI,EAAE,MAAM,QAAQ,KAAK;AAAA,MAC7D,EAAE;AAAA,MACF,WAAW,qBAAqB,aAAa,CAAC;AAAA,MAC9C,aAAa,qBAAqB,eAAe,CAAC;AAAA,IACpD,EAAE;AAAA,EACJ;AACF;AAEA,SAAS,mBAAmB,IAAkB;AAC5C,MAAI,CAAC,wCAAwC,KAAK,EAAE,GAAG;AACrD,UAAM,IAAI;AAAA,MACR,0BAA0B,EAAE;AAAA,IAC9B;AAAA,EACF;AACF;","names":[]}

package/package.json

@@ -1,7 +1,24 @@
 {
   "name": "@callsitehq/core",
-  "version": "0.1.0",
+  "version": "0.2.0",
   "description": "Authoring API and IR types for Callsite capabilities.",
+  "keywords": [
+    "agents",
+    "capabilities",
+    "mcp",
+    "openapi",
+    "typescript"
+  ],
+  "license": "MIT",
+  "homepage": "https://github.com/callsitehq/callsite/tree/main/packages/core#readme",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/callsitehq/callsite.git",
+    "directory": "packages/core"
+  },
+  "bugs": {
+    "url": "https://github.com/callsitehq/callsite/issues"
+  },
   "type": "module",
   "exports": {
     ".": {
@@ -12,7 +29,13 @@
   "files": [
     "dist"
   ],
+  "publishConfig": {
+    "access": "public"
+  },
   "sideEffects": false,
+  "devDependencies": {
+    "zod": "^4.0.0"
+  },
   "scripts": {
     "build": "tsup",
     "clean": "rm -rf dist *.tsbuildinfo",