@namzu/sdk 0.1.1 → 0.1.2

package/src/types/run/events.ts

@@ -1,159 +1,157 @@
-import type { BaseAgentResult } from "../agent/base.js";
-import type { CostInfo, TokenUsage } from "../common/index.js";
-import type { CheckpointId, ToolCallSummary } from "../hitl/index.js";
-import type { ActivityId, PlanId, RunId, TaskId } from "../ids/index.js";
-import type { PlanStep } from "../plan/index.js";
-import type { ActivityStatus, ActivityType } from "../activity/index.js";
-import type { TaskStatus } from "../task/index.js";
+import type { ActivityStatus, ActivityType } from '../activity/index.js'
+import type { BaseAgentResult } from '../agent/base.js'
+import type { CostInfo, TokenUsage } from '../common/index.js'
+import type { CheckpointId, ToolCallSummary } from '../hitl/index.js'
+import type { ActivityId, PlanId, RunId, TaskId } from '../ids/index.js'
+import type { PlanStep } from '../plan/index.js'
+import type { TaskStatus } from '../task/index.js'
 
 export type StopReason =
-	| "end_turn"
-	| "token_budget"
-	| "cost_limit"
-	| "timeout"
-	| "max_iterations"
-	| "cancelled"
-	| "plan_rejected"
-	| "paused"
-	| "error";
+	| 'end_turn'
+	| 'token_budget'
+	| 'cost_limit'
+	| 'timeout'
+	| 'max_iterations'
+	| 'cancelled'
+	| 'plan_rejected'
+	| 'paused'
+	| 'error'
 
 export type RunEvent =
-	| { type: "run_started"; runId: RunId; systemPrompt?: string }
-	| { type: "iteration_started"; runId: RunId; iteration: number }
+	| { type: 'run_started'; runId: RunId; systemPrompt?: string }
+	| { type: 'iteration_started'; runId: RunId; iteration: number }
 	| {
-			type: "iteration_completed";
-			runId: RunId;
-			iteration: number;
-			hasToolCalls: boolean;
+			type: 'iteration_completed'
+			runId: RunId
+			iteration: number
+			hasToolCalls: boolean
 	  }
 	| {
-			type: "llm_response";
-			runId: RunId;
-			content: string | null;
-			hasToolCalls: boolean;
+			type: 'llm_response'
+			runId: RunId
+			content: string | null
+			hasToolCalls: boolean
 	  }
 	| {
-			type: "tool_executing";
-			runId: RunId;
-			toolName: string;
-			input: unknown;
+			type: 'tool_executing'
+			runId: RunId
+			toolName: string
+			input: unknown
 	  }
 	| {
-			type: "tool_completed";
-			runId: RunId;
-			toolName: string;
-			result: string;
+			type: 'tool_completed'
+			runId: RunId
+			toolName: string
+			result: string
 	  }
 	| {
-			type: "tool_review_requested";
-			runId: RunId;
-			toolCalls: ToolCallSummary[];
-			iteration: number;
+			type: 'tool_review_requested'
+			runId: RunId
+			toolCalls: ToolCallSummary[]
+			iteration: number
 	  }
 	| {
-			type: "tool_review_completed";
-			runId: RunId;
-			decision: "approved" | "modified" | "rejected";
+			type: 'tool_review_completed'
+			runId: RunId
+			decision: 'approved' | 'modified' | 'rejected'
 	  }
 	| {
-			type: "checkpoint_created";
-			runId: RunId;
-			checkpointId: CheckpointId;
-			iteration: number;
+			type: 'checkpoint_created'
+			runId: RunId
+			checkpointId: CheckpointId
+			iteration: number
 	  }
 	| {
-			type: "run_paused";
-			runId: RunId;
-			checkpointId: CheckpointId;
-			reason: string;
+			type: 'run_paused'
+			runId: RunId
+			checkpointId: CheckpointId
+			reason: string
 	  }
 	| {
-			type: "run_resuming";
-			runId: RunId;
-			fromCheckpointId: CheckpointId;
+			type: 'run_resuming'
+			runId: RunId
+			fromCheckpointId: CheckpointId
 	  }
-	| { type: "run_completed"; runId: RunId; result: string }
-	| { type: "run_failed"; runId: RunId; error: string }
+	| { type: 'run_completed'; runId: RunId; result: string }
+	| { type: 'run_failed'; runId: RunId; error: string }
 	| {
-			type: "token_usage_updated";
-			runId: RunId;
-			usage: TokenUsage;
-			cost: CostInfo;
+			type: 'token_usage_updated'
+			runId: RunId
+			usage: TokenUsage
+			cost: CostInfo
 	  }
 	| {
-			type: "activity_created";
-			runId: RunId;
-			activityId: ActivityId;
-			activityType: ActivityType;
-			description: string;
+			type: 'activity_created'
+			runId: RunId
+			activityId: ActivityId
+			activityType: ActivityType
+			description: string
 	  }
 	| {
-			type: "activity_updated";
-			runId: RunId;
-			activityId: ActivityId;
-			status: ActivityStatus;
-			output?: unknown;
-			error?: string;
+			type: 'activity_updated'
+			runId: RunId
+			activityId: ActivityId
+			status: ActivityStatus
+			output?: unknown
+			error?: string
 	  }
 	| {
-			type: "plan_ready";
-			runId: RunId;
-			planId: PlanId;
-			title: string;
-			steps: PlanStep[];
-			summary?: string;
+			type: 'plan_ready'
+			runId: RunId
+			planId: PlanId
+			title: string
+			steps: PlanStep[]
+			summary?: string
 	  }
-	| { type: "plan_approved"; runId: RunId; planId: PlanId }
+	| { type: 'plan_approved'; runId: RunId; planId: PlanId }
 	| {
-			type: "plan_rejected";
-			runId: RunId;
-			planId: PlanId;
-			reason?: string;
+			type: 'plan_rejected'
+			runId: RunId
+			planId: PlanId
+			reason?: string
 	  }
 	| {
-			type: "plan_step_updated";
-			runId: RunId;
-			planId: PlanId;
-			stepId: string;
-			status: PlanStep["status"];
+			type: 'plan_step_updated'
+			runId: RunId
+			planId: PlanId
+			stepId: string
+			status: PlanStep['status']
 	  }
 	| {
-			type: "agent_pending";
-			runId: RunId;
-			taskId: TaskId;
-			parentAgentId: string;
-			childAgentId: string;
-			depth: number;
+			type: 'agent_pending'
+			runId: RunId
+			taskId: TaskId
+			parentAgentId: string
+			childAgentId: string
+			depth: number
 	  }
 	| {
-			type: "agent_completed";
-			runId: RunId;
-			taskId: TaskId;
-			result: BaseAgentResult;
+			type: 'agent_completed'
+			runId: RunId
+			taskId: TaskId
+			result: BaseAgentResult
 	  }
 	| {
-			type: "agent_failed";
-			runId: RunId;
-			taskId: TaskId;
-			error: string;
+			type: 'agent_failed'
+			runId: RunId
+			taskId: TaskId
+			error: string
 	  }
-	| { type: "agent_canceled"; runId: RunId; taskId: TaskId }
+	| { type: 'agent_canceled'; runId: RunId; taskId: TaskId }
 	| {
-			type: "task_created";
-			runId: RunId;
-			taskId: TaskId;
-			subject: string;
-			status: TaskStatus;
+			type: 'task_created'
+			runId: RunId
+			taskId: TaskId
+			subject: string
+			status: TaskStatus
 	  }
 	| {
-			type: "task_updated";
-			runId: RunId;
-			taskId: TaskId;
-			subject: string;
-			status: TaskStatus;
-			owner?: string;
-	  };
+			type: 'task_updated'
+			runId: RunId
+			taskId: TaskId
+			subject: string
+			status: TaskStatus
+			owner?: string
+	  }
 
-export type RunEventListener = (
-	event: RunEvent,
-) => void | Promise<void>;
+export type RunEventListener = (event: RunEvent) => void | Promise<void>

package/src/types/run/metadata.ts

@@ -1,39 +1,39 @@
-import type { RunId, ThreadId, TaskId } from '../ids/index.js'
-import type { AgentStatus, TokenUsage, CostInfo } from '../common/index.js'
+import type { AgentStatus, CostInfo, TokenUsage } from '../common/index.js'
+import type { RunId, TaskId, ThreadId } from '../ids/index.js'
 import type { StopReason } from './events.js'
 
 export interface RunMetadata {
-  id: RunId
-  threadId: ThreadId
-  agentId: string
-  agentName: string
-  status: AgentStatus
-  config: RunConfigSnapshot
-  provider: string
+	id: RunId
+	threadId: ThreadId
+	agentId: string
+	agentName: string
+	status: AgentStatus
+	config: RunConfigSnapshot
+	provider: string
 
-  parentRunId?: RunId
-  taskId?: TaskId
-  depth: number
+	parentRunId?: RunId
+	taskId?: TaskId
+	depth: number
 
-  tokenUsage: TokenUsage
-  costInfo: CostInfo
-  iterations: number
-  startedAt: number
-  endedAt?: number
-  durationMs?: number
-  stopReason?: StopReason
-  lastError?: string
-  result?: string
+	tokenUsage: TokenUsage
+	costInfo: CostInfo
+	iterations: number
+	startedAt: number
+	endedAt?: number
+	durationMs?: number
+	stopReason?: StopReason
+	lastError?: string
+	result?: string
 
-  childRunIds?: RunId[]
+	childRunIds?: RunId[]
 }
 
 export interface RunConfigSnapshot {
-  model: string
-  tokenBudget: number
-  timeoutMs: number
-  maxIterations?: number
-  temperature?: number
-  maxResponseTokens?: number
-  costLimitUsd?: number
+	model: string
+	tokenBudget: number
+	timeoutMs: number
+	maxIterations?: number
+	temperature?: number
+	maxResponseTokens?: number
+	costLimitUsd?: number
 }

package/src/types/run/state.ts

@@ -1,35 +1,35 @@
-import type { AgentStatus, TokenUsage, CostInfo } from '../common/index.js'
-import type { Message } from '../message/index.js'
+import type { AgentStatus, CostInfo, TokenUsage } from '../common/index.js'
 import type { RunId } from '../ids/index.js'
+import type { Message } from '../message/index.js'
 import type { AgentRunConfig } from './config.js'
 import type { StopReason } from './events.js'
 
 export interface RunStateMetadata {
-  agentId: string
-  agentName: string
-  config: AgentRunConfig
-  provider: string
+	agentId: string
+	agentName: string
+	config: AgentRunConfig
+	provider: string
 }
 
 export type SessionMetadata = RunStateMetadata
 
 export interface AgentRun {
-  id: RunId
-  status: AgentStatus
-  metadata: RunStateMetadata
-  messages: Message[]
-  tokenUsage: TokenUsage
-  costInfo: CostInfo
-  currentIteration: number
-  startedAt: number
-  endedAt?: number
-  stopReason?: StopReason
-  lastError?: string
-  result?: string
+	id: RunId
+	status: AgentStatus
+	metadata: RunStateMetadata
+	messages: Message[]
+	tokenUsage: TokenUsage
+	costInfo: CostInfo
+	currentIteration: number
+	startedAt: number
+	endedAt?: number
+	stopReason?: StopReason
+	lastError?: string
+	result?: string
 
-  parentRunId?: RunId
+	parentRunId?: RunId
 
-  depth?: number
+	depth?: number
 }
 
 export type AgentSession = AgentRun

package/src/types/skills/index.ts

@@ -1,34 +1,34 @@
 export interface SkillMetadata {
-  name: string
+	name: string
 
-  description: string
+	description: string
 
-  compatibility?: string
+	compatibility?: string
 
-  metadata?: Record<string, string>
+	metadata?: Record<string, string>
 }
 
 export interface Skill {
-  metadata: SkillMetadata
+	metadata: SkillMetadata
 
-  body?: string
+	body?: string
 
-  dirPath: string
+	dirPath: string
 }
 
 export type SkillDisclosureLevel = 'metadata' | 'full' | 'assets'
 
 export interface SkillLoadResult {
-  skill: Skill
-  disclosureLevel: SkillDisclosureLevel
+	skill: Skill
+	disclosureLevel: SkillDisclosureLevel
 
-  tokenEstimate: number
+	tokenEstimate: number
 }
 
 export interface SkillChain {
-  inherited: Skill[]
+	inherited: Skill[]
 
-  own: Skill[]
+	own: Skill[]
 
-  resolved: Skill[]
+	resolved: Skill[]
 }

package/src/types/task/index.ts

@@ -1,97 +1,93 @@
-import type { TaskId, RunId, TenantId } from '../ids/index.js'
+import type { RunId, TaskId, TenantId } from '../ids/index.js'
 
 export type TaskStatus = 'pending' | 'in_progress' | 'completed'
 
 export function isTerminalTaskStatus(status: TaskStatus): boolean {
-  return status === 'completed'
+	return status === 'completed'
 }
 
 export function assertTaskStatus(status: TaskStatus): void {
-  switch (status) {
-    case 'pending':
-    case 'in_progress':
-    case 'completed':
-      return
-    default: {
-      const _exhaustive: never = status
-      throw new Error(`Unknown TaskStatus: ${_exhaustive}`)
-    }
-  }
+	switch (status) {
+		case 'pending':
+		case 'in_progress':
+		case 'completed':
+			return
+		default: {
+			const _exhaustive: never = status
+			throw new Error(`Unknown TaskStatus: ${_exhaustive}`)
+		}
+	}
 }
 
 export interface Task {
-  readonly id: TaskId
-  readonly runId: RunId
-  readonly tenantId?: TenantId
+	readonly id: TaskId
+	readonly runId: RunId
+	readonly tenantId?: TenantId
 
-  subject: string
+	subject: string
 
-  description?: string
+	description?: string
 
-  activeForm?: string
+	activeForm?: string
 
-  status: TaskStatus
+	status: TaskStatus
 
-  owner?: string
+	owner?: string
 
-  blocks: TaskId[]
+	blocks: TaskId[]
 
-  blockedBy: TaskId[]
+	blockedBy: TaskId[]
 
-  metadata?: Record<string, unknown>
+	metadata?: Record<string, unknown>
 
-  createdAt: number
-  startedAt?: number
-  completedAt?: number
+	createdAt: number
+	startedAt?: number
+	completedAt?: number
 }
 
-export type TaskEventType =
-  | 'task.created'
-  | 'task.updated'
-  | 'task.deleted'
-  | 'task.claimed'
+export type TaskEventType = 'task.created' | 'task.updated' | 'task.deleted' | 'task.claimed'
 
 export interface TaskEvent {
-  type: TaskEventType
-  taskId: TaskId
-  task: Task
-  previousStatus?: TaskStatus
-  timestamp: number
+	type: TaskEventType
+	taskId: TaskId
+	task: Task
+	previousStatus?: TaskStatus
+	timestamp: number
 }
 
 export type TaskEventListener = (event: TaskEvent) => void
 
 export interface CreateTaskParams {
-  runId: RunId
-  tenantId?: TenantId
-  subject: string
-  description?: string
-  activeForm?: string
-  owner?: string
-  blockedBy?: TaskId[]
-  metadata?: Record<string, unknown>
+	runId: RunId
+	tenantId?: TenantId
+	subject: string
+	description?: string
+	activeForm?: string
+	owner?: string
+	blockedBy?: TaskId[]
+	metadata?: Record<string, unknown>
 }
 
 export interface UpdateTaskParams {
-  subject?: string
-  description?: string
-  activeForm?: string
-  status?: TaskStatus
-  owner?: string
-  metadata?: Record<string, unknown>
+	subject?: string
+	description?: string
+	activeForm?: string
+	status?: TaskStatus
+	owner?: string
+	metadata?: Record<string, unknown>
 }
 
 export interface TaskStore {
-  create(params: CreateTaskParams): Promise<Task>
-  get(id: TaskId): Promise<Task | undefined>
-  update(id: TaskId, updates: UpdateTaskParams): Promise<Task | undefined>
-  delete(id: TaskId): Promise<boolean>
-  list(filter?: { status?: TaskStatus; owner?: string; runId?: RunId }): Promise<Task[]>
+	create(params: CreateTaskParams): Promise<Task>
+	get(id: TaskId): Promise<Task | undefined>
+	update(id: TaskId, updates: UpdateTaskParams): Promise<Task | undefined>
+	delete(id: TaskId): Promise<boolean>
+	list(filter?: { status?: TaskStatus; owner?: string; runId?: RunId }): Promise<Task[]>
 
-  claim(id: TaskId, owner: string): Promise<Task | undefined>
+	claim(id: TaskId, owner: string): Promise<Task | undefined>
 
-  block(blockerId: TaskId, blockedId: TaskId): Promise<void>
+	block(blockerId: TaskId, blockedId: TaskId): Promise<void>
 
-  on(listener: TaskEventListener): () => void
-  reset(): Promise<void>
+	on(listener: TaskEventListener): () => void
+	reset(): Promise<void>
 }

package/src/types/telemetry/index.ts

@@ -1,10 +1,10 @@
 export type ExporterType = 'console' | 'otlp' | 'none'
 
 export interface TelemetryConfig {
-  serviceName: string
-  serviceVersion?: string
-  exporterType: ExporterType
-  otlpEndpoint?: string
-  otlpHeaders?: Record<string, string>
-  metricExportIntervalMs?: number
+	serviceName: string
+	serviceVersion?: string
+	exporterType: ExporterType
+	otlpEndpoint?: string
+	otlpHeaders?: Record<string, string>
+	metricExportIntervalMs?: number
 }