@harness-kernel/core 0.2.1 → 0.3.0

package/dist/chunk-NCSQEUQC.js

@@ -0,0 +1,37 @@
+// src/logging/tool-errors.ts
+function createToolErrorPayload(input) {
+  return {
+    ok: false,
+    error: {
+      code: input.code,
+      message: input.message,
+      toolName: input.toolName,
+      invalidFields: input.invalidFields,
+      metadata: input.metadata
+    }
+  };
+}
+function createToolErrorResult(input) {
+  return {
+    content: input.content ?? input.message,
+    data: createToolErrorPayload({
+      code: input.code,
+      message: input.message,
+      toolName: input.toolName,
+      invalidFields: input.invalidFields,
+      metadata: input.metadata
+    }),
+    isError: true,
+    metadata: {
+      errorCode: input.code,
+      ...input.invalidFields ? { invalidFields: input.invalidFields } : {},
+      ...input.metadata ?? {}
+    }
+  };
+}
+
+export {
+  createToolErrorPayload,
+  createToolErrorResult
+};
+//# sourceMappingURL=chunk-NCSQEUQC.js.map

package/dist/chunk-NCSQEUQC.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/logging/tool-errors.ts"],"sourcesContent":["import type { AgentToolResult } from \"../runtime/types/tools.js\";\nimport type { HarnessErrorCode } from \"../runtime/types/errors.js\";\n\nexport type ToolErrorCode =\n  Extract<HarnessErrorCode,\n    | \"tool.args.invalid_schema\"\n    | \"tool.approval.denied\"\n    | \"sandbox.exec.failed\"\n    | \"tool.failed\">;\n\nexport interface ToolInvalidField {\n  path: string;\n  code?: string;\n  expected?: string;\n  received?: string;\n  message: string;\n}\n\nexport interface ToolErrorPayload {\n  ok: false;\n  error: {\n    code: ToolErrorCode;\n    message: string;\n    toolName: string;\n    invalidFields?: ToolInvalidField[];\n    metadata?: Record<string, unknown>;\n  };\n}\n\nexport function createToolErrorPayload(input: {\n  code: ToolErrorCode;\n  message: string;\n  toolName: string;\n  invalidFields?: ToolInvalidField[];\n  metadata?: Record<string, unknown>;\n}): ToolErrorPayload {\n  return {\n    ok: false,\n    error: {\n      code: input.code,\n      message: input.message,\n      toolName: input.toolName,\n      invalidFields: input.invalidFields,\n      metadata: input.metadata,\n    },\n  };\n}\n\nexport function createToolErrorResult(input: {\n  code: ToolErrorCode;\n  message: string;\n  toolName: string;\n  content?: string;\n  invalidFields?: ToolInvalidField[];\n  metadata?: Record<string, unknown>;\n}): AgentToolResult<ToolErrorPayload> {\n  return {\n    content: input.content ?? input.message,\n    data: createToolErrorPayload({\n      code: input.code,\n      message: input.message,\n      toolName: input.toolName,\n      invalidFields: input.invalidFields,\n      metadata: input.metadata,\n    }),\n    isError: true,\n    metadata: {\n      errorCode: input.code,\n      ...(input.invalidFields ? { invalidFields: input.invalidFields } : {}),\n      ...(input.metadata ?? {}),\n    },\n  };\n}\n"],"mappings":";AA6BO,SAAS,uBAAuB,OAMlB;AACnB,SAAO;AAAA,IACL,IAAI;AAAA,IACJ,OAAO;AAAA,MACL,MAAM,MAAM;AAAA,MACZ,SAAS,MAAM;AAAA,MACf,UAAU,MAAM;AAAA,MAChB,eAAe,MAAM;AAAA,MACrB,UAAU,MAAM;AAAA,IAClB;AAAA,EACF;AACF;AAEO,SAAS,sBAAsB,OAOA;AACpC,SAAO;AAAA,IACL,SAAS,MAAM,WAAW,MAAM;AAAA,IAChC,MAAM,uBAAuB;AAAA,MAC3B,MAAM,MAAM;AAAA,MACZ,SAAS,MAAM;AAAA,MACf,UAAU,MAAM;AAAA,MAChB,eAAe,MAAM;AAAA,MACrB,UAAU,MAAM;AAAA,IAClB,CAAC;AAAA,IACD,SAAS;AAAA,IACT,UAAU;AAAA,MACR,WAAW,MAAM;AAAA,MACjB,GAAI,MAAM,gBAAgB,EAAE,eAAe,MAAM,cAAc,IAAI,CAAC;AAAA,MACpE,GAAI,MAAM,YAAY,CAAC;AAAA,IACzB;AAAA,EACF;AACF;","names":[]}

package/dist/{chunk-B4Q6CPYO.js → chunk-TCHZYK5Y.js}

@@ -119,6 +119,7 @@ var HarnessContextProvider = class {
   label;
   priority;
   role;
+  required;
   get type() {
     return constructTypeOf(this);
   }
@@ -137,6 +138,7 @@ var HarnessMode = class {
   tools;
   maxTurns;
   toolApproval;
+  contextFailure;
   get type() {
     return constructTypeOf(this);
   }
@@ -177,4 +179,4 @@ export {
   HarnessMode,
   HarnessHook
 };
-//# sourceMappingURL=chunk-B4Q6CPYO.js.map
+//# sourceMappingURL=chunk-TCHZYK5Y.js.map

package/dist/{chunk-B4Q6CPYO.js.map → chunk-TCHZYK5Y.js.map}

@@ -1 +1 @@
-{"version":3,"sources":["../src/runtime/types/events.ts","../src/runtime/types/naming.ts","../src/runtime/types/roles.ts","../src/runtime/types/tools.ts","../src/runtime/types/context.ts","../src/runtime/types/modes.ts","../src/runtime/types/hooks.ts"],"sourcesContent":["import type { JsonObject } from \"./json.js\";\n\nexport interface HarnessEventMetadata extends JsonObject {\n  label?: string;\n}\n\nexport interface HarnessEventSource {\n  kind: \"runtime\" | \"model_provider\" | \"tool\" | \"hook\" | \"context_provider\" | \"mode\" | \"user\" | \"custom\";\n  id?: string;\n  name?: string;\n}\n\nexport interface HarnessEventRecord<TPayload = unknown> {\n  id: string;\n  seq: number;\n  branchId: string;\n  type: string;\n  eventClassId: string;\n  at: string;\n  source: HarnessEventSource;\n  payload: TPayload;\n  runId: string;\n  turnId?: string;\n  modeId?: string;\n  correlationId?: string;\n  causationId?: string;\n  hidden: true;\n  metadata?: HarnessEventMetadata;\n}\n\nexport abstract class HarnessEvent<TPayload = unknown> {\n  static type?: string;\n  static schema?: unknown;\n\n  constructor(readonly record: HarnessEventRecord<TPayload>) {}\n\n  get id(): string {\n    return this.record.id;\n  }\n\n  get type(): string {\n    return this.record.type;\n  }\n\n  get payload(): TPayload {\n    return this.record.payload;\n  }\n\n  get at(): string {\n    return this.record.at;\n  }\n}\n\nexport type HarnessEventClass<\n  TPayload = unknown,\n  TEvent extends HarnessEvent<TPayload> = HarnessEvent<TPayload>,\n> = {\n  readonly type?: string;\n  readonly schema?: unknown;\n  new (record: HarnessEventRecord<any>): TEvent;\n};\n\nexport interface HarnessEventEmitOptions {\n  source?: HarnessEventSource;\n  correlationId?: string;\n  causationId?: string;\n  metadata?: HarnessEventMetadata;\n  hiddenTranscript?: boolean;\n  skipHooks?: boolean;\n}\n\nexport interface HarnessEventQuery<TPayload = unknown> {\n  event?: HarnessEventClass<TPayload>;\n  type?: string;\n  sourceKind?: HarnessEventSource[\"kind\"];\n  limit?: number;\n  since?: string;\n  until?: string;\n  includeInactive?: boolean;\n}\n\nexport interface EventCursor {\n  id: string;\n  branchId: string;\n  headEventId?: string;\n  seq: number;\n  updatedAt: string;\n}\n\nexport type RunnerEventListener = (event: HarnessEventRecord) => void | Promise<void>;\n","function constructorOf(value: object): { readonly type?: string; readonly label?: string; readonly name?: string } {\n  return value.constructor as { readonly type?: string; readonly label?: string; readonly name?: string };\n}\n\nexport function constructTypeOf(value: object): string {\n  const ctor = constructorOf(value);\n  return ctor.type ?? ctor.name ?? \"AnonymousConstruct\";\n}\n\nfunction stripConstructSuffix(name: string): string {\n  return name.replace(/(Tool|Mode|Provider|ContextProvider|Hook|Role|Event)$/u, \"\");\n}\n\nfunction wordsFromName(name: string): string[] {\n  const spaced = name\n    .replace(/[_:-]+/gu, \" \")\n    .replace(/([a-z0-9])([A-Z])/gu, \"$1 $2\")\n    .replace(/([A-Z]+)([A-Z][a-z])/gu, \"$1 $2\")\n    .trim();\n  return spaced ? spaced.split(/\\s+/u) : [name];\n}\n\nexport function labelFromType(type: string): string {\n  return wordsFromName(stripConstructSuffix(type))\n    .map((word) => word.charAt(0).toUpperCase() + word.slice(1))\n    .join(\" \");\n}\n\nexport function snakeFromType(type: string): string {\n  return wordsFromName(stripConstructSuffix(type))\n    .map((word) => word.toLowerCase())\n    .join(\"_\");\n}\n","import { constructTypeOf } from \"./naming.js\";\n\nexport interface HarnessRoleSummary {\n  type: string;\n  name: string;\n  label?: string;\n  target: string;\n  nativeRole?: string;\n  default?: boolean;\n  description?: string;\n}\n\nexport enum RoleTargets {\n  System = \"system\",\n  Messages = \"messages\",\n  Hidden = \"hidden\",\n}\n\nexport enum NativeRoles {\n  System = \"system\",\n  User = \"user\",\n  Assistant = \"assistant\",\n  Tool = \"tool\",\n}\n\nexport abstract class HarnessRole {\n  protected declare readonly __harnessRoleBrand: true;\n\n  label?: string;\n  name?: string;\n  abstract target: RoleTargets | (string & {});\n  nativeRole?: NativeRoles | (string & {});\n  default?: boolean;\n  description?: string;\n\n  get type(): string {\n    return constructTypeOf(this);\n  }\n\n}\n\nexport type HarnessRoleClass<TRole extends HarnessRole = HarnessRole> = abstract new (...args: any[]) => TRole;\nexport type HarnessRoleDefinition = HarnessRole;\nexport type HarnessRoleSelector<TRole extends HarnessRole = HarnessRole> = TRole | HarnessRoleClass<TRole>;\n\nexport class SystemRole extends HarnessRole {\n  static type = \"system\";\n  label = \"System\";\n  name = \"system\";\n  target = RoleTargets.System;\n  nativeRole = NativeRoles.System;\n  default = true;\n}\n\nexport class UserRole extends HarnessRole {\n  static type = \"user\";\n  label = \"User\";\n  name = \"user\";\n  target = RoleTargets.Messages;\n  nativeRole = NativeRoles.User;\n}\n\nexport class AssistantRole extends HarnessRole {\n  static type = \"assistant\";\n  label = \"Assistant\";\n  name = \"assistant\";\n  target = RoleTargets.Messages;\n  nativeRole = NativeRoles.Assistant;\n}\n\nexport class ToolRole extends HarnessRole {\n  static type = \"tool\";\n  label = \"Tool\";\n  name = \"tool\";\n  target = RoleTargets.Messages;\n  nativeRole = NativeRoles.Tool;\n}\n\nexport const systemRole = new SystemRole();\nexport const userRole = new UserRole();\nexport const assistantRole = new AssistantRole();\nexport const toolRole = new ToolRole();\n","import type { AgentActionSession } from \"./sessions.js\";\nimport type { JsonObject } from \"./json.js\";\nimport { constructTypeOf } from \"./naming.js\";\n\nexport type ToolApprovalMode = \"auto\" | \"ask\" | \"deny\" | \"tool-default\";\nexport type ToolApprovalDecision = \"approved\" | \"denied\";\nexport type ToolRisk = \"safe\" | \"read\" | \"write\" | \"execute\" | \"network\" | \"destructive\";\n\nexport interface ToolPermission {\n  kind: \"filesystem\" | \"shell\" | \"network\" | \"custom\";\n  access?: \"read\" | \"write\" | \"execute\";\n  path?: string;\n  description?: string;\n}\n\nexport type ToolRef =\n  | { kind: \"file\"; path: string; role?: \"created\" | \"modified\" | \"read\" | \"evidence\" }\n  | { kind: \"url\"; url: string; role?: string }\n  | { kind: \"command\"; command: string; exitCode?: number; role?: string }\n  | { kind: \"tool_call\"; toolName: string; callId?: string; role?: string }\n  | { kind: \"session\"; sessionId: string; role?: string }\n  | { kind: \"external\"; label: string; uri?: string; role?: string };\n\nexport interface ToolCatalogEntry {\n  name: string;\n  description: string;\n  risk?: ToolRisk;\n  permissions?: ToolPermission[];\n  requiresApproval?: boolean;\n}\n\nexport type ToolApprovalResolver = (\n  args: unknown,\n  session: AgentActionSession,\n) => boolean | Promise<boolean>;\n\nexport interface AgentToolResult<TData = unknown> {\n  content: string;\n  data?: TData;\n  refs?: ToolRef[];\n  metadata?: JsonObject;\n  isError?: boolean;\n}\n\nexport abstract class HarnessTool<TInput = unknown, TData = unknown> {\n  protected declare readonly __harnessToolBrand: true;\n\n  label?: string;\n  abstract name: string;\n  abstract description: string;\n  schema?: unknown;\n  risk?: ToolRisk;\n  permissions?: ToolPermission[];\n  requiresApproval?: boolean | ToolApprovalResolver;\n  approvalTimeoutMs?: number;\n\n  get type(): string {\n    return constructTypeOf(this);\n  }\n\n  get inputSchema(): unknown {\n    return this.schema;\n  }\n\n  abstract execute(args: TInput, session: AgentActionSession): AgentToolResult<TData> | Promise<AgentToolResult<TData>>;\n}\n\nexport type HarnessToolClass<TTool extends HarnessTool = HarnessTool> = abstract new (...args: any[]) => TTool;\nexport type HarnessToolSelector<TTool extends HarnessTool = HarnessTool> = TTool | HarnessToolClass<TTool>;\nexport type AgentToolDefinition<TInput = unknown, TData = unknown> = HarnessTool<TInput, TData>;\nexport type AgentToolSource = HarnessTool;\n\nexport interface ToolApprovalRequest {\n  id: string;\n  name: string;\n  args: unknown;\n  modeId: string;\n  risk?: ToolRisk;\n  permissions?: ToolPermission[];\n  approvalTimeoutMs?: number;\n}\n","import type { AgentReadSession } from \"./sessions.js\";\nimport type { AgentMessage } from \"./messages.js\";\nimport type { HarnessEventClass } from \"./events.js\";\nimport type { HarnessRoleSelector } from \"./roles.js\";\nimport type { JsonObject } from \"./json.js\";\nimport { constructTypeOf } from \"./naming.js\";\n\nexport type HarnessContextProviderClass<\n  TProvider extends HarnessContextProvider = HarnessContextProvider,\n> = abstract new (...args: any[]) => TProvider;\n\nexport type HarnessContextProviderSelector<TOptions extends JsonObject = JsonObject> =\n  | HarnessContextProvider<TOptions>\n  | HarnessContextProviderClass<HarnessContextProvider<TOptions>>;\n\nexport interface ContextProviderBinding<TOptions extends JsonObject = JsonObject> {\n  provider: HarnessContextProviderSelector<TOptions>;\n  options?: TOptions;\n}\n\nexport type ContextProviderReference<TOptions extends JsonObject = JsonObject> =\n  | HarnessContextProviderSelector<TOptions>\n  | ContextProviderBinding<TOptions>;\n\nexport interface ContextProviderSummary {\n  type: string;\n  label?: string;\n  options?: JsonObject;\n}\n\nexport interface ContextContribution {\n  providerId?: string;\n  providerLabel?: string;\n  role: string;\n  authorRole?: string;\n  roleType?: string;\n  content: unknown;\n  metadata?: JsonObject;\n}\n\nexport enum ContextScopes {\n  Turn = \"turn\",\n  Run = \"run\",\n  Session = \"session\",\n}\n\nexport enum ContextConsume {\n  Once = \"once\",\n  WhileActive = \"while_active\",\n}\n\nexport interface ContextRegistrationOptions {\n  scope?: ContextScopes;\n  on?: HarnessEventClass;\n  consume?: ContextConsume;\n  id?: string;\n  replace?: boolean;\n  metadata?: JsonObject;\n}\n\nexport interface ContextEntry {\n  id: string;\n  scope: ContextScopes;\n  on: string;\n  consume: ContextConsume;\n  createdAt: string;\n  activatedAt?: string;\n  activatedByEventId?: string;\n  activatedByEventType?: string;\n  runId: string;\n  turnId?: string;\n  modeId: string;\n  contribution: ContextContribution;\n  metadata?: JsonObject;\n}\n\nexport interface ContextEntryFilter {\n  id?: string;\n  scope?: ContextScopes;\n  consume?: ContextConsume;\n  providerId?: string;\n  role?: string;\n  on?: HarnessEventClass;\n}\n\nexport type ContextProviderOutput =\n  | string\n  | ContextContributionInput\n  | Array<string | ContextContributionInput>\n  | null\n  | undefined;\n\nexport interface ContextContributionInput {\n  role?: HarnessRoleSelector;\n  content: unknown;\n  metadata?: JsonObject;\n}\n\nexport interface ContextProviderRenderResult {\n  providerId: string;\n  providerLabel?: string;\n  binding: ContextProviderSummary;\n  contributions: ContextContribution[];\n}\n\nexport interface ContextSnapshot {\n  id: string;\n  turnId?: string;\n  modeId: string;\n  createdAt: string;\n  providers: ContextProviderRenderResult[];\n  contributions: ContextContribution[];\n  systemPrompt: string;\n  messages: AgentMessage[];\n}\n\nexport abstract class HarnessContextProvider<TOptions extends JsonObject = JsonObject> {\n  protected declare readonly __harnessContextProviderBrand: true;\n\n  label?: string;\n  priority?: number;\n  role?: HarnessRoleSelector;\n\n  get type(): string {\n    return constructTypeOf(this);\n  }\n\n  with(options: TOptions): ContextProviderBinding<TOptions> {\n    return { provider: this, options };\n  }\n\n  abstract render(session: AgentReadSession, options?: TOptions): ContextProviderOutput | Promise<ContextProviderOutput>;\n}\n\nexport type AgentContextProvider<TOptions extends JsonObject = JsonObject> = HarnessContextProvider<TOptions>;\n","import type { AgentActionSession, AgentReadSession } from \"./sessions.js\";\nimport type { AgentToolSource, ToolApprovalMode } from \"./tools.js\";\nimport type { ContextProviderReference } from \"./context.js\";\nimport { constructTypeOf } from \"./naming.js\";\n\nexport interface HarnessModeSummary {\n  type: string;\n  label: string;\n}\n\nexport abstract class HarnessMode {\n  protected declare readonly __harnessModeBrand: true;\n\n  label?: string;\n  model?: string;\n  prompt?: string | ((session: AgentReadSession) => string | Promise<string>);\n  providers?: \"all\" | ContextProviderReference[];\n  excludeProviders?: string[];\n  tools?: AgentToolSource[];\n  maxTurns?: number;\n  toolApproval?: ToolApprovalMode;\n\n  get type(): string {\n    return constructTypeOf(this);\n  }\n\n  getPrompt?(session: AgentReadSession): string | Promise<string>;\n  onEnter?(session: AgentActionSession, input?: unknown): void | Promise<void>;\n  onExit?(session: AgentActionSession, nextMode: HarnessModeSummary): void | Promise<void>;\n}\n\nexport type HarnessModeClass<TMode extends HarnessMode = HarnessMode> = abstract new (...args: any[]) => TMode;\nexport type HarnessModeSelector<TMode extends HarnessMode = HarnessMode> = TMode | HarnessModeClass<TMode>;\nexport type AgentModeDefinition = HarnessMode;\n","import type { AgentActionSession } from \"./sessions.js\";\nimport type { HarnessEvent, HarnessEventClass } from \"./events.js\";\nimport { constructTypeOf } from \"./naming.js\";\n\nexport interface HarnessHookSummary {\n  type: string;\n  label: string;\n  eventType: string;\n  eventClassId: string;\n}\n\nexport abstract class HarnessHook<TEvent extends HarnessEvent = HarnessEvent> {\n  protected declare readonly __harnessHookBrand: true;\n\n  label?: string;\n  readonly eventClass?: HarnessEventClass<any, TEvent>;\n\n  static for<TPayload, TEvent extends HarnessEvent<TPayload>>(\n    eventClass: HarnessEventClass<TPayload, TEvent>,\n  ): abstract new () => HarnessHook<TEvent> {\n    abstract class BoundHarnessHook extends HarnessHook<TEvent> {\n      override readonly eventClass: HarnessEventClass<any, TEvent> = eventClass;\n    }\n    return BoundHarnessHook;\n  }\n\n  get type(): string {\n    return constructTypeOf(this);\n  }\n\n  abstract onActive(session: AgentActionSession, event: TEvent): void | Promise<void>;\n}\n\nexport type HarnessHookEventClass<TEvent extends HarnessEvent = HarnessEvent> = abstract new () => HarnessHook<TEvent>;\n"],"mappings":"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","names":["RoleTargets","NativeRoles","ContextScopes","ContextConsume"]}
+{"version":3,"sources":["../src/runtime/types/events.ts","../src/runtime/types/naming.ts","../src/runtime/types/roles.ts","../src/runtime/types/tools.ts","../src/runtime/types/context.ts","../src/runtime/types/modes.ts","../src/runtime/types/hooks.ts"],"sourcesContent":["import type { JsonObject } from \"./json.js\";\n\nexport interface HarnessEventMetadata extends JsonObject {\n  label?: string;\n}\n\nexport interface HarnessEventSource {\n  kind: \"runtime\" | \"model_provider\" | \"tool\" | \"hook\" | \"context_provider\" | \"mode\" | \"user\" | \"custom\";\n  id?: string;\n  name?: string;\n}\n\nexport interface HarnessEventRecord<TPayload = unknown> {\n  id: string;\n  seq: number;\n  branchId: string;\n  type: string;\n  eventClassId: string;\n  at: string;\n  source: HarnessEventSource;\n  payload: TPayload;\n  runId: string;\n  turnId?: string;\n  modeId?: string;\n  correlationId?: string;\n  causationId?: string;\n  hidden: true;\n  metadata?: HarnessEventMetadata;\n}\n\nexport abstract class HarnessEvent<TPayload = unknown> {\n  static type?: string;\n  static schema?: unknown;\n\n  constructor(readonly record: HarnessEventRecord<TPayload>) {}\n\n  get id(): string {\n    return this.record.id;\n  }\n\n  get type(): string {\n    return this.record.type;\n  }\n\n  get payload(): TPayload {\n    return this.record.payload;\n  }\n\n  get at(): string {\n    return this.record.at;\n  }\n}\n\nexport type HarnessEventClass<\n  TPayload = unknown,\n  TEvent extends HarnessEvent<TPayload> = HarnessEvent<TPayload>,\n> = {\n  readonly type?: string;\n  readonly schema?: unknown;\n  new (record: HarnessEventRecord<any>): TEvent;\n};\n\nexport interface HarnessEventEmitOptions {\n  source?: HarnessEventSource;\n  correlationId?: string;\n  causationId?: string;\n  metadata?: HarnessEventMetadata;\n  hiddenTranscript?: boolean;\n  skipHooks?: boolean;\n}\n\nexport interface HarnessEventQuery<TPayload = unknown> {\n  event?: HarnessEventClass<TPayload>;\n  type?: string;\n  sourceKind?: HarnessEventSource[\"kind\"];\n  limit?: number;\n  since?: string;\n  until?: string;\n  includeInactive?: boolean;\n}\n\nexport interface EventCursor {\n  id: string;\n  branchId: string;\n  headEventId?: string;\n  seq: number;\n  updatedAt: string;\n}\n\nexport type RunnerEventListener = (event: HarnessEventRecord) => void | Promise<void>;\n","function constructorOf(value: object): { readonly type?: string; readonly label?: string; readonly name?: string } {\n  return value.constructor as { readonly type?: string; readonly label?: string; readonly name?: string };\n}\n\nexport function constructTypeOf(value: object): string {\n  const ctor = constructorOf(value);\n  return ctor.type ?? ctor.name ?? \"AnonymousConstruct\";\n}\n\nfunction stripConstructSuffix(name: string): string {\n  return name.replace(/(Tool|Mode|Provider|ContextProvider|Hook|Role|Event)$/u, \"\");\n}\n\nfunction wordsFromName(name: string): string[] {\n  const spaced = name\n    .replace(/[_:-]+/gu, \" \")\n    .replace(/([a-z0-9])([A-Z])/gu, \"$1 $2\")\n    .replace(/([A-Z]+)([A-Z][a-z])/gu, \"$1 $2\")\n    .trim();\n  return spaced ? spaced.split(/\\s+/u) : [name];\n}\n\nexport function labelFromType(type: string): string {\n  return wordsFromName(stripConstructSuffix(type))\n    .map((word) => word.charAt(0).toUpperCase() + word.slice(1))\n    .join(\" \");\n}\n\nexport function snakeFromType(type: string): string {\n  return wordsFromName(stripConstructSuffix(type))\n    .map((word) => word.toLowerCase())\n    .join(\"_\");\n}\n","import { constructTypeOf } from \"./naming.js\";\n\nexport interface HarnessRoleSummary {\n  type: string;\n  name: string;\n  label?: string;\n  target: string;\n  nativeRole?: string;\n  default?: boolean;\n  description?: string;\n}\n\nexport enum RoleTargets {\n  System = \"system\",\n  Messages = \"messages\",\n  Hidden = \"hidden\",\n}\n\nexport enum NativeRoles {\n  System = \"system\",\n  User = \"user\",\n  Assistant = \"assistant\",\n  Tool = \"tool\",\n}\n\nexport abstract class HarnessRole {\n  protected declare readonly __harnessRoleBrand: true;\n\n  label?: string;\n  name?: string;\n  abstract target: RoleTargets | (string & {});\n  nativeRole?: NativeRoles | (string & {});\n  default?: boolean;\n  description?: string;\n\n  get type(): string {\n    return constructTypeOf(this);\n  }\n\n}\n\nexport type HarnessRoleClass<TRole extends HarnessRole = HarnessRole> = abstract new (...args: any[]) => TRole;\nexport type HarnessRoleDefinition = HarnessRole;\nexport type HarnessRoleSelector<TRole extends HarnessRole = HarnessRole> = TRole | HarnessRoleClass<TRole>;\n\nexport class SystemRole extends HarnessRole {\n  static type = \"system\";\n  label = \"System\";\n  name = \"system\";\n  target = RoleTargets.System;\n  nativeRole = NativeRoles.System;\n  default = true;\n}\n\nexport class UserRole extends HarnessRole {\n  static type = \"user\";\n  label = \"User\";\n  name = \"user\";\n  target = RoleTargets.Messages;\n  nativeRole = NativeRoles.User;\n}\n\nexport class AssistantRole extends HarnessRole {\n  static type = \"assistant\";\n  label = \"Assistant\";\n  name = \"assistant\";\n  target = RoleTargets.Messages;\n  nativeRole = NativeRoles.Assistant;\n}\n\nexport class ToolRole extends HarnessRole {\n  static type = \"tool\";\n  label = \"Tool\";\n  name = \"tool\";\n  target = RoleTargets.Messages;\n  nativeRole = NativeRoles.Tool;\n}\n\nexport const systemRole = new SystemRole();\nexport const userRole = new UserRole();\nexport const assistantRole = new AssistantRole();\nexport const toolRole = new ToolRole();\n","import type { AgentActionSession } from \"./sessions.js\";\nimport type { JsonObject } from \"./json.js\";\nimport { constructTypeOf } from \"./naming.js\";\n\nexport type ToolApprovalMode = \"auto\" | \"ask\" | \"deny\" | \"tool-default\";\nexport type ToolApprovalDecision = \"approved\" | \"denied\";\nexport type ToolRisk = \"safe\" | \"read\" | \"write\" | \"execute\" | \"network\" | \"destructive\";\n\nexport interface ToolPermission {\n  kind: \"filesystem\" | \"shell\" | \"network\" | \"custom\";\n  access?: \"read\" | \"write\" | \"execute\";\n  path?: string;\n  description?: string;\n}\n\nexport type ToolRef =\n  | { kind: \"file\"; path: string; role?: \"created\" | \"modified\" | \"read\" | \"evidence\" }\n  | { kind: \"url\"; url: string; role?: string }\n  | { kind: \"command\"; command: string; exitCode?: number; role?: string }\n  | { kind: \"tool_call\"; toolName: string; callId?: string; role?: string }\n  | { kind: \"session\"; sessionId: string; role?: string }\n  | { kind: \"external\"; label: string; uri?: string; role?: string };\n\nexport interface ToolCatalogEntry {\n  name: string;\n  description: string;\n  risk?: ToolRisk;\n  permissions?: ToolPermission[];\n  requiresApproval?: boolean;\n}\n\nexport type ToolApprovalResolver = (\n  args: unknown,\n  session: AgentActionSession,\n) => boolean | Promise<boolean>;\n\nexport interface AgentToolResult<TData = unknown> {\n  content: string;\n  data?: TData;\n  refs?: ToolRef[];\n  metadata?: JsonObject;\n  isError?: boolean;\n}\n\nexport abstract class HarnessTool<TInput = unknown, TData = unknown> {\n  protected declare readonly __harnessToolBrand: true;\n\n  label?: string;\n  abstract name: string;\n  abstract description: string;\n  schema?: unknown;\n  risk?: ToolRisk;\n  permissions?: ToolPermission[];\n  requiresApproval?: boolean | ToolApprovalResolver;\n  approvalTimeoutMs?: number;\n\n  get type(): string {\n    return constructTypeOf(this);\n  }\n\n  get inputSchema(): unknown {\n    return this.schema;\n  }\n\n  abstract execute(args: TInput, session: AgentActionSession): AgentToolResult<TData> | Promise<AgentToolResult<TData>>;\n}\n\nexport type HarnessToolClass<TTool extends HarnessTool = HarnessTool> = abstract new (...args: any[]) => TTool;\nexport type HarnessToolSelector<TTool extends HarnessTool = HarnessTool> = TTool | HarnessToolClass<TTool>;\nexport type AgentToolDefinition<TInput = unknown, TData = unknown> = HarnessTool<TInput, TData>;\nexport type AgentToolSource = HarnessTool;\n\nexport interface ToolApprovalRequest {\n  id: string;\n  name: string;\n  args: unknown;\n  modeId: string;\n  risk?: ToolRisk;\n  permissions?: ToolPermission[];\n  approvalTimeoutMs?: number;\n}\n","import type { AgentReadSession } from \"./sessions.js\";\nimport type { AgentMessage } from \"./messages.js\";\nimport type { HarnessEventClass } from \"./events.js\";\nimport type { HarnessRoleSelector } from \"./roles.js\";\nimport type { JsonObject } from \"./json.js\";\nimport { constructTypeOf } from \"./naming.js\";\n\nexport type HarnessContextProviderClass<\n  TProvider extends HarnessContextProvider = HarnessContextProvider,\n> = abstract new (...args: any[]) => TProvider;\n\nexport type HarnessContextProviderSelector<TOptions extends JsonObject = JsonObject> =\n  | HarnessContextProvider<TOptions>\n  | HarnessContextProviderClass<HarnessContextProvider<TOptions>>;\n\nexport interface ContextProviderBinding<TOptions extends JsonObject = JsonObject> {\n  provider: HarnessContextProviderSelector<TOptions>;\n  options?: TOptions;\n  required?: boolean;\n}\n\nexport type ContextProviderReference<TOptions extends JsonObject = JsonObject> =\n  | HarnessContextProviderSelector<TOptions>\n  | ContextProviderBinding<TOptions>;\n\nexport interface ContextProviderSummary {\n  type: string;\n  label?: string;\n  options?: JsonObject;\n}\n\nexport interface ContextContribution {\n  providerId?: string;\n  providerLabel?: string;\n  role: string;\n  authorRole?: string;\n  roleType?: string;\n  content: unknown;\n  metadata?: JsonObject;\n}\n\nexport enum ContextScopes {\n  Turn = \"turn\",\n  Run = \"run\",\n  Session = \"session\",\n}\n\nexport enum ContextConsume {\n  Once = \"once\",\n  WhileActive = \"while_active\",\n}\n\nexport interface ContextRegistrationOptions {\n  scope?: ContextScopes;\n  on?: HarnessEventClass;\n  consume?: ContextConsume;\n  id?: string;\n  replace?: boolean;\n  metadata?: JsonObject;\n}\n\nexport interface ContextEntry {\n  id: string;\n  scope: ContextScopes;\n  on: string;\n  consume: ContextConsume;\n  createdAt: string;\n  activatedAt?: string;\n  activatedByEventId?: string;\n  activatedByEventType?: string;\n  runId: string;\n  turnId?: string;\n  modeId: string;\n  contribution: ContextContribution;\n  metadata?: JsonObject;\n}\n\nexport interface ContextEntryFilter {\n  id?: string;\n  scope?: ContextScopes;\n  consume?: ContextConsume;\n  providerId?: string;\n  role?: string;\n  on?: HarnessEventClass;\n}\n\nexport type ContextProviderOutput =\n  | string\n  | ContextContributionInput\n  | Array<string | ContextContributionInput>\n  | null\n  | undefined;\n\nexport interface ContextContributionInput {\n  role?: HarnessRoleSelector;\n  content: unknown;\n  metadata?: JsonObject;\n}\n\nexport interface ContextProviderRenderResult {\n  providerId: string;\n  providerLabel?: string;\n  binding: ContextProviderSummary;\n  contributions: ContextContribution[];\n}\n\nexport interface ContextSnapshot {\n  id: string;\n  turnId?: string;\n  modeId: string;\n  createdAt: string;\n  providers: ContextProviderRenderResult[];\n  contributions: ContextContribution[];\n  systemPrompt: string;\n  messages: AgentMessage[];\n}\n\nexport abstract class HarnessContextProvider<TOptions extends JsonObject = JsonObject> {\n  protected declare readonly __harnessContextProviderBrand: true;\n\n  label?: string;\n  priority?: number;\n  role?: HarnessRoleSelector;\n  required?: boolean;\n\n  get type(): string {\n    return constructTypeOf(this);\n  }\n\n  with(options: TOptions): ContextProviderBinding<TOptions> {\n    return { provider: this, options };\n  }\n\n  abstract render(session: AgentReadSession, options?: TOptions): ContextProviderOutput | Promise<ContextProviderOutput>;\n}\n\nexport type AgentContextProvider<TOptions extends JsonObject = JsonObject> = HarnessContextProvider<TOptions>;\n","import type { AgentActionSession, AgentReadSession } from \"./sessions.js\";\nimport type { AgentToolSource, ToolApprovalMode } from \"./tools.js\";\nimport type { ContextProviderReference } from \"./context.js\";\nimport { constructTypeOf } from \"./naming.js\";\n\nexport interface HarnessModeSummary {\n  type: string;\n  label: string;\n}\n\nexport abstract class HarnessMode {\n  protected declare readonly __harnessModeBrand: true;\n\n  label?: string;\n  model?: string;\n  prompt?: string | ((session: AgentReadSession) => string | Promise<string>);\n  providers?: \"all\" | ContextProviderReference[];\n  excludeProviders?: string[];\n  tools?: AgentToolSource[];\n  maxTurns?: number;\n  toolApproval?: ToolApprovalMode;\n  contextFailure?: \"fail\" | \"warn-and-skip\";\n\n  get type(): string {\n    return constructTypeOf(this);\n  }\n\n  getPrompt?(session: AgentReadSession): string | Promise<string>;\n  onEnter?(session: AgentActionSession, input?: unknown): void | Promise<void>;\n  onExit?(session: AgentActionSession, nextMode: HarnessModeSummary): void | Promise<void>;\n}\n\nexport type HarnessModeClass<TMode extends HarnessMode = HarnessMode> = abstract new (...args: any[]) => TMode;\nexport type HarnessModeSelector<TMode extends HarnessMode = HarnessMode> = TMode | HarnessModeClass<TMode>;\nexport type AgentModeDefinition = HarnessMode;\n","import type { AgentActionSession } from \"./sessions.js\";\nimport type { HarnessEvent, HarnessEventClass } from \"./events.js\";\nimport { constructTypeOf } from \"./naming.js\";\n\nexport interface HarnessHookSummary {\n  type: string;\n  label: string;\n  eventType: string;\n  eventClassId: string;\n}\n\nexport abstract class HarnessHook<TEvent extends HarnessEvent = HarnessEvent> {\n  protected declare readonly __harnessHookBrand: true;\n\n  label?: string;\n  readonly eventClass?: HarnessEventClass<any, TEvent>;\n\n  static for<TPayload, TEvent extends HarnessEvent<TPayload>>(\n    eventClass: HarnessEventClass<TPayload, TEvent>,\n  ): abstract new () => HarnessHook<TEvent> {\n    abstract class BoundHarnessHook extends HarnessHook<TEvent> {\n      override readonly eventClass: HarnessEventClass<any, TEvent> = eventClass;\n    }\n    return BoundHarnessHook;\n  }\n\n  get type(): string {\n    return constructTypeOf(this);\n  }\n\n  abstract onActive(session: AgentActionSession, event: TEvent): void | Promise<void>;\n}\n\nexport type HarnessHookEventClass<TEvent extends HarnessEvent = HarnessEvent> = abstract new () => HarnessHook<TEvent>;\n"],"mappings":"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","names":["RoleTargets","NativeRoles","ContextScopes","ContextConsume"]}