@namzu/sdk 0.4.1 → 0.4.3

package/dist/tools/builtins/__tests__/structuredOutput.example.js

@@ -1,183 +0,0 @@
-/**
- * Real-world examples of using createStructuredOutputTool
- *
- * These examples demonstrate how to use the structured output tool
- * to force agents to produce validated, typed output.
- */
-import { z } from 'zod';
-import { createStructuredOutputTool } from '../structuredOutput.js';
-// ============================================================================
-// Example 1: Code Review Analysis
-// ============================================================================
-const CodeReviewSchema = z.object({
-    status: z.enum(['approved', 'changes_requested', 'rejected']),
-    summary: z.string().describe('Overall summary of the review'),
-    issues: z.array(z.object({
-        file: z.string(),
-        line: z.number().int().positive(),
-        severity: z.enum(['critical', 'major', 'minor']),
-        message: z.string(),
-        suggestion: z.string().optional(),
-    })),
-    strengths: z.array(z.string()).describe('What was done well'),
-    suggestions: z.array(z.string()).describe('Actionable improvements'),
-});
-export const createCodeReviewTool = () => createStructuredOutputTool(CodeReviewSchema);
-// Usage example:
-// const tool = createCodeReviewTool()
-// await toolRegistry.register(tool)
-// // Model analyzes code...
-// const review = extractToolResult(messages, 'structured_output')
-// const typedReview: z.infer<typeof CodeReviewSchema> = JSON.parse(review.output)
-// ============================================================================
-// Example 2: Document Summarization
-// ============================================================================
-const DocumentSummarySchema = z.object({
-    title: z.string(),
-    category: z.enum(['technical', 'business', 'legal', 'other']),
-    summary: z.string().min(100).max(500),
-    key_points: z.array(z.string()).min(3).max(10),
-    metadata: z.object({
-        source: z.string().optional(),
-        date: z.string().datetime().optional(),
-        language: z.string().default('en'),
-    }),
-});
-export const createDocumentSummaryTool = () => createStructuredOutputTool(DocumentSummarySchema);
-// ============================================================================
-// Example 3: Data Extraction
-// ============================================================================
-const ExtractedDataSchema = z.object({
-    entities: z.array(z.object({
-        type: z.enum(['person', 'organization', 'location', 'date', 'amount']),
-        text: z.string(),
-        confidence: z.number().min(0).max(1),
-    })),
-    relationships: z.array(z.object({
-        subject: z.string(),
-        predicate: z.string(),
-        object: z.string(),
-    })),
-});
-export const createDataExtractionTool = () => createStructuredOutputTool(ExtractedDataSchema);
-// ============================================================================
-// Example 4: Task Execution Status
-// ============================================================================
-const TaskResultSchema = z.object({
-    task_id: z.string(),
-    status: z.enum(['success', 'partial', 'failed']),
-    result: z.record(z.unknown()).describe('Task-specific result data'),
-    errors: z
-        .array(z.object({
-        code: z.string(),
-        message: z.string(),
-        details: z.string().optional(),
-    }))
-        .default([]),
-    metadata: z.object({
-        duration_ms: z.number().int().positive().optional(),
-        attempts: z.number().int().min(1),
-        timestamp: z.string().datetime(),
-    }),
-});
-export const createTaskResultTool = () => createStructuredOutputTool(TaskResultSchema);
-// ============================================================================
-// Example 5: Diagnosis/Decision Making
-// ============================================================================
-const DiagnosisSchema = z.object({
-    diagnosis: z.string(),
-    confidence: z.number().min(0).max(1),
-    differential: z.array(z.object({
-        diagnosis: z.string(),
-        probability: z.number().min(0).max(1),
-    })),
-    recommended_actions: z.array(z.string()),
-    urgency: z.enum(['low', 'medium', 'high', 'critical']),
-});
-export const createDiagnosisTool = () => createStructuredOutputTool(DiagnosisSchema);
-// ============================================================================
-// Example 6: Multi-language Translation
-// ============================================================================
-const TranslationSchema = z.object({
-    source_text: z.string(),
-    source_language: z.string(),
-    target_language: z.string(),
-    translation: z.string(),
-    confidence: z.number().min(0).max(1),
-    notes: z.string().optional(),
-    alternatives: z
-        .array(z.object({
-        text: z.string(),
-        note: z.string(),
-    }))
-        .optional(),
-});
-export const createTranslationTool = () => createStructuredOutputTool(TranslationSchema);
-// ============================================================================
-// Example 7: Test Report Generation
-// ============================================================================
-const TestReportSchema = z.object({
-    total_tests: z.number().int().nonnegative(),
-    passed: z.number().int().nonnegative(),
-    failed: z.number().int().nonnegative(),
-    skipped: z.number().int().nonnegative(),
-    coverage_percent: z.number().min(0).max(100),
-    failures: z.array(z.object({
-        test_name: z.string(),
-        error_message: z.string(),
-        stack_trace: z.string().optional(),
-    })),
-    summary: z.string(),
-});
-export const createTestReportTool = () => createStructuredOutputTool(TestReportSchema);
-// ============================================================================
-// Integration Pattern
-// ============================================================================
-/**
- * Example of how to integrate structured output into an agent iteration:
- *
- * ```typescript
- * async function queryWithStructuredOutput(
- *   toolRegistry: ToolRegistry,
- *   schema: z.ZodType,
- *   messages: Message[]
- * ): Promise<any> {
- *   const tool = createStructuredOutputTool(schema)
- *
- *   try {
- *     // Register the tool
- *     toolRegistry.register(tool)
- *
- *     // Run the iteration with this tool available
- *     // (in real usage, this would be integrated with the iteration loop)
- *     const response = await provider.chat({
- *       messages,
- *       tools: toolRegistry.toLLMTools(),
- *       toolChoice: {
- *         type: 'function',
- *         function: { name: 'structured_output' }
- *       }
- *     })
- *
- *     // Extract the result
- *     const toolCall = response.message.toolCalls?.find(
- *       tc => tc.function.name === 'structured_output'
- *     )
- *
- *     if (toolCall) {
- *       const args = JSON.parse(toolCall.function.arguments)
- *       return {
- *         success: true,
- *         data: args
- *       }
- *     }
- *
- *     return { success: false, error: 'Tool was not called' }
- *   } finally {
- *     // Clean up
- *     toolRegistry.unregister('structured_output')
- *   }
- * }
- * ```
- */
-//# sourceMappingURL=structuredOutput.example.js.map

package/dist/tools/builtins/__tests__/structuredOutput.example.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"structuredOutput.example.js","sourceRoot":"","sources":["../../../../src/tools/builtins/__tests__/structuredOutput.example.ts"],"names":[],"mappings":"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"}

package/dist/types/run/state.d.ts

@@ -1,30 +0,0 @@
-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 './stop-reason.js';
-export interface RunStateMetadata {
-    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;
-    parentRunId?: RunId;
-    depth?: number;
-}
-export type AgentSession = AgentRun;
-//# sourceMappingURL=state.d.ts.map

package/dist/types/run/state.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"state.d.ts","sourceRoot":"","sources":["../../../src/types/run/state.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,QAAQ,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAA;AAC3E,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,iBAAiB,CAAA;AAC5C,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAA;AAClD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,aAAa,CAAA;AACjD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAA;AAElD,MAAM,WAAW,gBAAgB;IAChC,OAAO,EAAE,MAAM,CAAA;IACf,SAAS,EAAE,MAAM,CAAA;IACjB,MAAM,EAAE,cAAc,CAAA;IACtB,QAAQ,EAAE,MAAM,CAAA;CAChB;AAED,MAAM,MAAM,eAAe,GAAG,gBAAgB,CAAA;AAE9C,MAAM,WAAW,QAAQ;IACxB,EAAE,EAAE,KAAK,CAAA;IACT,MAAM,EAAE,WAAW,CAAA;IACnB,QAAQ,EAAE,gBAAgB,CAAA;IAC1B,QAAQ,EAAE,OAAO,EAAE,CAAA;IACnB,UAAU,EAAE,UAAU,CAAA;IACtB,QAAQ,EAAE,QAAQ,CAAA;IAClB,gBAAgB,EAAE,MAAM,CAAA;IACxB,SAAS,EAAE,MAAM,CAAA;IACjB,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,UAAU,CAAC,EAAE,UAAU,CAAA;IACvB,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,MAAM,CAAC,EAAE,MAAM,CAAA;IAEf,WAAW,CAAC,EAAE,KAAK,CAAA;IAEnB,KAAK,CAAC,EAAE,MAAM,CAAA;CACd;AAED,MAAM,MAAM,YAAY,GAAG,QAAQ,CAAA"}

package/dist/types/run/state.js

@@ -1,2 +0,0 @@
-export {};
-//# sourceMappingURL=state.js.map

package/dist/types/run/state.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"state.js","sourceRoot":"","sources":["../../../src/types/run/state.ts"],"names":[],"mappings":""}

package/src/contracts/ids.ts

@@ -1 +0,0 @@
-export type { ProjectId, RunId, MessageId, SessionId } from '../types/ids/index.js'

package/src/session/hierarchy/index.ts

@@ -1,18 +0,0 @@
-// Sub-barrel for the session-hierarchy entity model.
-// Convention #4: concrete types live in sibling files; re-export them here.
-
-export type { ActorRef, SystemRoleId } from './actor.js'
-export type { Lineage } from './lineage.js'
-export type { Tenant } from './tenant.js'
-export type { Project, ProjectConfig } from './project.js'
-export type { Thread, ThreadStatus } from './thread.js'
-export type { Session, SessionStatus } from './session.js'
-export { deriveStatus } from './session.js'
-export type {
-	SubSession,
-	SubSessionStatus,
-	SubSessionKind,
-	FailureMode,
-	CompletionMode,
-	DeliverableRef,
-} from './sub-session.js'

package/src/tools/builtins/__tests__/structuredOutput.example.ts

@@ -1,221 +0,0 @@
-/**
- * Real-world examples of using createStructuredOutputTool
- *
- * These examples demonstrate how to use the structured output tool
- * to force agents to produce validated, typed output.
- */
-
-import { z } from 'zod'
-import { createStructuredOutputTool } from '../structuredOutput.js'
-
-// ============================================================================
-// Example 1: Code Review Analysis
-// ============================================================================
-
-const CodeReviewSchema = z.object({
-	status: z.enum(['approved', 'changes_requested', 'rejected']),
-	summary: z.string().describe('Overall summary of the review'),
-	issues: z.array(
-		z.object({
-			file: z.string(),
-			line: z.number().int().positive(),
-			severity: z.enum(['critical', 'major', 'minor']),
-			message: z.string(),
-			suggestion: z.string().optional(),
-		}),
-	),
-	strengths: z.array(z.string()).describe('What was done well'),
-	suggestions: z.array(z.string()).describe('Actionable improvements'),
-})
-
-export const createCodeReviewTool = () => createStructuredOutputTool(CodeReviewSchema)
-
-// Usage example:
-// const tool = createCodeReviewTool()
-// await toolRegistry.register(tool)
-// // Model analyzes code...
-// const review = extractToolResult(messages, 'structured_output')
-// const typedReview: z.infer<typeof CodeReviewSchema> = JSON.parse(review.output)
-
-// ============================================================================
-// Example 2: Document Summarization
-// ============================================================================
-
-const DocumentSummarySchema = z.object({
-	title: z.string(),
-	category: z.enum(['technical', 'business', 'legal', 'other']),
-	summary: z.string().min(100).max(500),
-	key_points: z.array(z.string()).min(3).max(10),
-	metadata: z.object({
-		source: z.string().optional(),
-		date: z.string().datetime().optional(),
-		language: z.string().default('en'),
-	}),
-})
-
-export const createDocumentSummaryTool = () => createStructuredOutputTool(DocumentSummarySchema)
-
-// ============================================================================
-// Example 3: Data Extraction
-// ============================================================================
-
-const ExtractedDataSchema = z.object({
-	entities: z.array(
-		z.object({
-			type: z.enum(['person', 'organization', 'location', 'date', 'amount']),
-			text: z.string(),
-			confidence: z.number().min(0).max(1),
-		}),
-	),
-	relationships: z.array(
-		z.object({
-			subject: z.string(),
-			predicate: z.string(),
-			object: z.string(),
-		}),
-	),
-})
-
-export const createDataExtractionTool = () => createStructuredOutputTool(ExtractedDataSchema)
-
-// ============================================================================
-// Example 4: Task Execution Status
-// ============================================================================
-
-const TaskResultSchema = z.object({
-	task_id: z.string(),
-	status: z.enum(['success', 'partial', 'failed']),
-	result: z.record(z.unknown()).describe('Task-specific result data'),
-	errors: z
-		.array(
-			z.object({
-				code: z.string(),
-				message: z.string(),
-				details: z.string().optional(),
-			}),
-		)
-		.default([]),
-	metadata: z.object({
-		duration_ms: z.number().int().positive().optional(),
-		attempts: z.number().int().min(1),
-		timestamp: z.string().datetime(),
-	}),
-})
-
-export const createTaskResultTool = () => createStructuredOutputTool(TaskResultSchema)
-
-// ============================================================================
-// Example 5: Diagnosis/Decision Making
-// ============================================================================
-
-const DiagnosisSchema = z.object({
-	diagnosis: z.string(),
-	confidence: z.number().min(0).max(1),
-	differential: z.array(
-		z.object({
-			diagnosis: z.string(),
-			probability: z.number().min(0).max(1),
-		}),
-	),
-	recommended_actions: z.array(z.string()),
-	urgency: z.enum(['low', 'medium', 'high', 'critical']),
-})
-
-export const createDiagnosisTool = () => createStructuredOutputTool(DiagnosisSchema)
-
-// ============================================================================
-// Example 6: Multi-language Translation
-// ============================================================================
-
-const TranslationSchema = z.object({
-	source_text: z.string(),
-	source_language: z.string(),
-	target_language: z.string(),
-	translation: z.string(),
-	confidence: z.number().min(0).max(1),
-	notes: z.string().optional(),
-	alternatives: z
-		.array(
-			z.object({
-				text: z.string(),
-				note: z.string(),
-			}),
-		)
-		.optional(),
-})
-
-export const createTranslationTool = () => createStructuredOutputTool(TranslationSchema)
-
-// ============================================================================
-// Example 7: Test Report Generation
-// ============================================================================
-
-const TestReportSchema = z.object({
-	total_tests: z.number().int().nonnegative(),
-	passed: z.number().int().nonnegative(),
-	failed: z.number().int().nonnegative(),
-	skipped: z.number().int().nonnegative(),
-	coverage_percent: z.number().min(0).max(100),
-	failures: z.array(
-		z.object({
-			test_name: z.string(),
-			error_message: z.string(),
-			stack_trace: z.string().optional(),
-		}),
-	),
-	summary: z.string(),
-})
-
-export const createTestReportTool = () => createStructuredOutputTool(TestReportSchema)
-
-// ============================================================================
-// Integration Pattern
-// ============================================================================
-
-/**
- * Example of how to integrate structured output into an agent iteration:
- *
- * ```typescript
- * async function queryWithStructuredOutput(
- *   toolRegistry: ToolRegistry,
- *   schema: z.ZodType,
- *   messages: Message[]
- * ): Promise<any> {
- *   const tool = createStructuredOutputTool(schema)
- *
- *   try {
- *     // Register the tool
- *     toolRegistry.register(tool)
- *
- *     // Run the iteration with this tool available
- *     // (in real usage, this would be integrated with the iteration loop)
- *     const response = await provider.chat({
- *       messages,
- *       tools: toolRegistry.toLLMTools(),
- *       toolChoice: {
- *         type: 'function',
- *         function: { name: 'structured_output' }
- *       }
- *     })
- *
- *     // Extract the result
- *     const toolCall = response.message.toolCalls?.find(
- *       tc => tc.function.name === 'structured_output'
- *     )
- *
- *     if (toolCall) {
- *       const args = JSON.parse(toolCall.function.arguments)
- *       return {
- *         success: true,
- *         data: args
- *       }
- *     }
- *
- *     return { success: false, error: 'Tool was not called' }
- *   } finally {
- *     // Clean up
- *     toolRegistry.unregister('structured_output')
- *   }
- * }
- * ```
- */

package/src/types/run/state.ts

@@ -1,35 +0,0 @@
-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 './stop-reason.js'
-
-export interface RunStateMetadata {
-	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
-
-	parentRunId?: RunId
-
-	depth?: number
-}
-
-export type AgentSession = AgentRun