@sixb/core 0.1.7 → 0.1.9

package/dist/chunk-dmn70ztd.js.map

@@ -0,0 +1,11 @@
+{
+  "version": 3,
+  "sources": ["../src/agents/errors.ts", "../src/agents/context/entries.ts"],
+  "sourcesContent": [
+    "/**\n * Base error for the agents module. Specific subclasses extend this so callers\n * can catch any agent-scoped failure with a single `instanceof AgentDefinitionError` check.\n */\nexport class AgentDefinitionError extends Error {\n  readonly name: string = \"AgentDefinitionError\"\n}\n\n/**\n * An agent-tool failure whose message is intentionally safe to expose to the model and persist in\n * the durable trace. Tool authors must keep the message free of credentials and internal details;\n * unknown errors remain masked by the worker.\n */\nexport class AgentToolPublicError extends Error {\n  readonly name: string = \"AgentToolPublicError\"\n}\n\n/** Raised when an agent tool result cannot cross the durable message boundary. */\nexport class AgentToolResultValidationError extends Error {\n  readonly name = \"AgentToolResultValidationError\"\n\n  constructor(\n    readonly toolName: string,\n    readonly reason: string,\n    options?: ErrorOptions\n  ) {\n    super(`[Sixb] Agent tool '${toolName}' returned an invalid result; ${reason}.`, options)\n  }\n}\n\nexport type AgentRequestErrorCode =\n  | \"agent_selector_removed\"\n  | \"agent_not_found\"\n  | \"model_not_found\"\n  | \"invalid_model_selection\"\n  | \"run_not_found\"\n  | \"run_not_retryable\"\n  | \"thread_not_found\"\n  | \"active_run_exists\"\n  | \"authority_not_inheritable\"\n  | \"invalid_context\"\n  | \"storage_unavailable\"\n\n/**\n * Raised by {@link requestAgentRun} (the trigger). Callers branch on `code` rather than message text\n * — e.g. the HTTP layer maps `active_run_exists` to 409 and `agent_not_found` to 404.\n */\nexport class AgentRequestError extends Error {\n  readonly name = \"AgentRequestError\"\n\n  constructor(\n    readonly code: AgentRequestErrorCode,\n    message: string\n  ) {\n    super(message)\n  }\n}\n",
+    "import type { JsonValue } from \"../../json\"\nimport { cloneJsonValue, getInvalidJsonValueReason, stableJsonStringify } from \"../../json\"\nimport type { ObjectRef } from \"../../ontology/refs\"\nimport { AgentRequestError } from \"../errors\"\n\nexport type AgentContextInput =\n  | { readonly kind: \"object\"; readonly ref: ObjectRef }\n  | {\n      readonly kind: \"app-state\"\n      readonly id: string\n      readonly label: string\n      readonly description: string\n      readonly value: JsonValue\n    }\n\nexport type AgentContextOrigin = \"ambient\" | \"explicit\"\n\nexport interface AgentContextEntryInput {\n  readonly context: AgentContextInput\n  readonly origin: AgentContextOrigin\n}\n\n/** Durable user-message part. Origin is display provenance, never an authorization grant. */\nexport interface AgentContextPart extends AgentContextEntryInput {\n  readonly type: \"context\"\n}\n\nexport const MAX_AGENT_CONTEXT_ENTRIES = 12\nexport const MAX_AGENT_APP_STATE_ENTRY_BYTES = 16 * 1024\nexport const MAX_AGENT_APP_STATE_TOTAL_BYTES = 64 * 1024\n\n/** Typed constructors for context values shared by custom apps and agent clients. */\nexport const agentContext = {\n  object<const TObjectTypeId extends string>(\n    objectType: { readonly id: TObjectTypeId },\n    primaryId: string\n  ) {\n    return {\n      kind: \"object\" as const,\n      ref: { objectTypeId: objectType.id, primaryId },\n    }\n  },\n\n  appState<const TValue extends JsonValue>(\n    id: string,\n    input: {\n      readonly label: string\n      readonly description: string\n      readonly value: TValue\n    }\n  ) {\n    return { kind: \"app-state\" as const, id, ...input }\n  },\n}\n\n/** Stable identity shared by core deduplication and context-aware clients. */\nexport function agentContextIdentity(context: AgentContextInput): string {\n  return context.kind === \"object\"\n    ? `object:${encodeURIComponent(context.ref.objectTypeId)}:${encodeURIComponent(context.ref.primaryId)}`\n    : `app-state:${encodeURIComponent(context.id)}`\n}\n\n/** Stable semantic key for client-side comparisons. */\nexport function agentContextFingerprint(context: AgentContextInput): string {\n  return stableJsonStringify(context)\n}\n\n/**\n * Validate transport-independent context rules and clone mutable app state before it can become\n * durable. Object existence and visibility are resolved separately because they require a runtime.\n */\nexport function normalizeAgentContextEntries(\n  input: readonly AgentContextEntryInput[] | undefined\n): readonly AgentContextEntryInput[] {\n  if (input === undefined) return []\n  if (!Array.isArray(input)) invalidContext(\"context must be an array\")\n  if (input.length > MAX_AGENT_CONTEXT_ENTRIES) {\n    invalidContext(`context cannot contain more than ${MAX_AGENT_CONTEXT_ENTRIES} entries`)\n  }\n\n  const entries: AgentContextEntryInput[] = []\n  const byIdentity = new Map<string, string>()\n  let totalAppStateBytes = 0\n\n  for (const [index, rawEntry] of input.entries()) {\n    const entry = normalizeEntry(rawEntry, index)\n    const identity = agentContextIdentity(entry.context)\n    const serialized = stableJsonStringify(entry)\n    const existing = byIdentity.get(identity)\n\n    if (existing !== undefined) {\n      if (existing === serialized) continue\n      invalidContext(`context contains conflicting entries for '${identity}'`)\n    }\n\n    if (entry.context.kind === \"app-state\") {\n      const bytes = utf8ByteLength(serialized)\n      if (bytes > MAX_AGENT_APP_STATE_ENTRY_BYTES) {\n        invalidContext(\n          `context entry '${identity}' exceeds the ${MAX_AGENT_APP_STATE_ENTRY_BYTES}-byte limit`\n        )\n      }\n      totalAppStateBytes += bytes\n      if (totalAppStateBytes > MAX_AGENT_APP_STATE_TOTAL_BYTES) {\n        invalidContext(\n          `app-state context exceeds the ${MAX_AGENT_APP_STATE_TOTAL_BYTES}-byte message limit`\n        )\n      }\n    }\n\n    byIdentity.set(identity, serialized)\n    entries.push(entry)\n  }\n\n  return entries\n}\n\nfunction normalizeEntry(rawEntry: unknown, index: number): AgentContextEntryInput {\n  if (!isRecord(rawEntry)) invalidContext(`context[${index}] must be an object`)\n  if (rawEntry.origin !== \"ambient\" && rawEntry.origin !== \"explicit\") {\n    invalidContext(`context[${index}].origin must be 'ambient' or 'explicit'`)\n  }\n  if (!isRecord(rawEntry.context)) invalidContext(`context[${index}].context must be an object`)\n\n  const context = rawEntry.context\n  if (context.kind === \"object\") {\n    if (!isRecord(context.ref)) invalidContext(`context[${index}].context.ref must be an object`)\n    const objectTypeId = requireNonEmptyString(\n      context.ref.objectTypeId,\n      `context[${index}].context.ref.objectTypeId`\n    )\n    const primaryId = requireNonEmptyString(\n      context.ref.primaryId,\n      `context[${index}].context.ref.primaryId`\n    )\n    return {\n      context: { kind: \"object\", ref: { objectTypeId, primaryId } },\n      origin: rawEntry.origin,\n    }\n  }\n\n  if (context.kind === \"app-state\") {\n    const id = requireNonEmptyString(context.id, `context[${index}].context.id`)\n    const label = requireNonEmptyString(context.label, `context[${index}].context.label`)\n    const description = requireNonEmptyString(\n      context.description,\n      `context[${index}].context.description`\n    )\n    const reason = getInvalidJsonValueReason(context.value, `context[${index}].context.value`)\n    if (reason) {\n      invalidContext(`context[${index}].context.value must be a JSON value; ${reason}`)\n    }\n    return {\n      context: {\n        kind: \"app-state\",\n        id,\n        label,\n        description,\n        value: cloneJsonValue(context.value as JsonValue),\n      },\n      origin: rawEntry.origin,\n    }\n  }\n\n  invalidContext(`context[${index}].context.kind must be 'object' or 'app-state'`)\n}\n\nfunction requireNonEmptyString(value: unknown, label: string): string {\n  if (typeof value !== \"string\" || value.trim().length === 0) {\n    invalidContext(`${label} must be a non-empty string`)\n  }\n  return value\n}\n\nfunction utf8ByteLength(value: string): number {\n  return new TextEncoder().encode(value).byteLength\n}\n\nfunction isRecord(value: unknown): value is Record<string, unknown> {\n  return typeof value === \"object\" && value !== null && !Array.isArray(value)\n}\n\nfunction invalidContext(message: string): never {\n  throw new AgentRequestError(\"invalid_context\", `[Sixb] Invalid agent context: ${message}.`)\n}\n"
+  ],
+  "mappings": "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",
+  "debugId": "20BA4BBDB86CC4AA64756E2164756E21",
+  "names": []
+}