@od-oneapp/ai-platform 0.1.0

package/README.md

@@ -0,0 +1,235 @@
+# @od-oneapp/ai-platform
+
+Enterprise patterns library for Vercel AI SDK v6. Provides standardized agent orchestration, compliance policies, and
+tooling for monorepo environments.
+
+> **Note**: This package replaces the deprecated `@repo/ai` package. Enhanced AI chat hooks have been migrated to
+> `@od-oneapp/uni-ui/hooks/ai-chat`. See the migration guide in the main repository documentation.
+
+## Installation
+
+```bash
+pnpm add @od-oneapp/ai-platform
+```
+
+## Structure
+
+```
+src/
+├── models/                     # Model registry & routing
+│   ├── index.ts                # Main exports
+│   ├── registry.ts             # Model enum, metadata
+│   ├── gateway.ts              # Cloudflare/Vercel/direct routing
+│   ├── helpers.ts              # getModelTier, estimateCost
+│   └── routing/                # Intent and model routing
+│
+├── agents/                     # Agent orchestration
+│   ├── index.ts
+│   ├── base/                   # Base agent patterns
+│   ├── triage/                 # Request routing agents
+│   ├── coordinator/            # Multi-agent coordination
+│   ├── experimental/           # Experimental agent patterns
+│   ├── persistence/            # State persistence
+│   ├── observability/          # Agent telemetry
+│   ├── control-flow/           # Execution control
+│   ├── multi/                  # Multi-agent patterns
+│   │   ├── coordination/       # Agent coordination
+│   │   ├── state/              # Shared state management
+│   │   ├── supervisor/         # Supervisor strategies
+│   │   └── swarm/              # Swarm patterns
+│   ├── fallback/               # Error recovery
+│   └── workflows/              # Workflow orchestration
+│
+├── streaming/                  # Streaming utilities
+│   ├── index.ts
+│   ├── core/                   # Base stream utilities
+│   ├── control/                # Abort, pause, resume, budget
+│   └── infra/                  # Infrastructure
+│       ├── backpressure/       # Backpressure handling
+│       ├── multiplexing/       # Stream merging, broadcast
+│       ├── resilience/         # Reconnection, resumption
+│       └── transport/          # SSE/WebSocket adapters
+│
+├── grounding/                  # RAG & verification
+│   ├── index.ts
+│   ├── embed/                  # Chunking, embeddings, vector store
+│   ├── rag/                    # RAG pipeline, reranking
+│   ├── context/                # Context management
+│   ├── context-engineering/    # Context optimization
+│   ├── hallucination/          # Claim extraction, verification
+│   ├── citation/               # Source citation
+│   ├── verification/           # Fact verification
+│   ├── sources/                # Source management
+│   └── attribution/            # Attribution reporting
+│
+├── sdk/                        # Vercel AI SDK v6 extensions
+│   ├── index.ts
+│   ├── errors/                 # PlatformAIError hierarchy
+│   ├── stop-conditions/        # stopWhen utilities
+│   ├── experimental/           # LanguageModelV1Middleware
+│   └── middleware/             # Custom middleware
+│
+├── security/                   # Security concerns
+│   ├── index.ts
+│   ├── guardrails/             # Content guardrails
+│   ├── injection/              # Prompt injection defense
+│   └── output/                 # Output sanitization
+│
+├── governance/                 # Compliance & policies
+│   ├── index.ts
+│   ├── compliance/             # ABAC, approval workflows
+│   ├── audit/                  # Audit logging
+│   ├── policies/               # Policy engine
+│   ├── tenancy/                # Multi-tenant isolation, quotas
+│   ├── approval/               # Approval workflows
+│   └── versioning/             # Version control
+│
+├── observability/              # Monitoring & costs
+│   ├── index.ts
+│   ├── telemetry/              # OpenTelemetry integration
+│   ├── tracing/                # Distributed tracing
+│   ├── analytics/              # Usage analytics
+│   └── cost/                   # Cost tracking, attribution
+│
+├── hitl/                       # Human-in-the-loop
+│   ├── index.ts
+│   ├── approval/               # Human approval gates
+│   ├── feedback/               # Feedback collection
+│   ├── annotation/             # Annotation tools
+│   ├── active-learning/        # Sample selection strategies
+│   └── review/                 # Review workflows
+│
+├── tools/                      # Tool execution
+│   ├── index.ts
+│   ├── core/                   # Base tool patterns
+│   ├── generic/                # Generic tools
+│   ├── advanced/               # Advanced patterns
+│   ├── artifacts/              # Artifact handling
+│   ├── computer/               # Computer use
+│   ├── mcp/                    # MCP integration
+│   └── superpowers/            # Specialized capabilities
+│
+├── output/                     # Structured output
+│   ├── index.ts
+│   └── multimodal/             # Vision/audio types
+│
+├── prompts/                    # Prompt management
+│   └── index.ts
+│
+├── pipelines/                  # Pipeline orchestration
+│   ├── index.ts
+│   ├── builder.ts
+│   └── validation.ts
+│
+├── caching/                    # Response caching
+│   ├── index.ts
+│   ├── adapters/               # Redis, memory adapters
+│   └── strategies/             # Cache strategies
+│
+├── internal/                   # Shared internals (not exported)
+│   ├── helpers/                # Error handling, retry, rate-limit
+│   ├── testing/                # Mocks, fixtures, evaluation
+│   ├── http/                   # HTTP utilities
+│   ├── routes/                 # API routes
+│   ├── messages/               # Message handling
+│   ├── shared/                 # Shared utilities
+│   ├── ui/                     # UI components
+│   └── ui-factories/           # UI factory patterns
+│
+├── index.ts                    # Main public exports
+└── types.ts                    # Public type exports
+```
+
+## Usage
+
+### Model Registry
+
+```typescript
+import { Model, getModelMetadata, getModelTier } from "@od-oneapp/ai-platform/models";
+
+// Semantic model names
+const model = Model.SONNET;
+const metadata = getModelMetadata(model);
+console.log(metadata.costPer1kInput); // 0.003
+
+// Get model tier
+const tier = getModelTier(Model.OPUS); // 'powerful'
+```
+
+### Agent Patterns
+
+```typescript
+import { createAgent } from '@od-oneapp/ai-platform/agents';
+import { stopWhen } from '@od-oneapp/ai-platform/sdk/stop-conditions';
+
+const agent = createAgent({
+  name: 'support',
+  model: Model.SONNET,
+  tools: [...],
+});
+
+// With stop conditions
+const result = await agent.run({
+  prompt: 'Help the user',
+  stopCondition: stopWhen.toolCalled('complete'),
+});
+```
+
+### Streaming
+
+```typescript
+import { createStreamController } from "@od-oneapp/ai-platform/streaming/control";
+
+const controller = createStreamController({
+  budget: { maxTokens: 1000 },
+  onBudgetExceeded: () => console.log("Budget exceeded")
+});
+```
+
+### Grounding & RAG
+
+```typescript
+import { createChunker, createEmbedder, createRAGPipeline } from "@od-oneapp/ai-platform/grounding";
+
+const chunker = createChunker({ strategy: "paragraph", chunkSize: 500 });
+const pipeline = createRAGPipeline({ embedder, vectorStore, topK: 5 });
+
+const context = await pipeline.retrieve("What is the capital of France?");
+```
+
+### Security
+
+```typescript
+import { createGuardrail } from "@od-oneapp/ai-platform/security";
+
+const guardrail = createGuardrail({
+  rules: [
+    { type: "pii", action: "redact" },
+    { type: "injection", action: "block" }
+  ]
+});
+```
+
+### Observability
+
+```typescript
+import { createTracer } from "@od-oneapp/ai-platform/observability/tracing";
+
+const tracer = createTracer({
+  serviceName: "my-ai-service",
+  exporters: [consoleExporter]
+});
+```
+
+## Design Principles
+
+This library follows Vercel AI SDK v6 conventions:
+
+1. **Flat structure** - Max 2 levels of nesting
+2. **Function-oriented naming** - Each module does one thing
+3. **SDK alignment** - Extends rather than replaces SDK patterns
+4. **Enterprise-ready** - Adds governance, security, observability
+
+## License
+
+Private - Internal use only.

package/dist/agents-base.d.mts

@@ -0,0 +1,12 @@
+import "./ai-runtime-DIwOEc6g.mjs";
+import { a as AgentExecutionOptions, c as BaseAgentState, d as ToolCallRecord, i as AgentContext, l as StopCondition, n as AgentConfig, o as AgentFactory, r as AgentConfigSchema, s as AgentMessage, t as Agent, u as StopConditions } from "./types-DbUfMCnT.mjs";
+import { a as agentStructuredOutputSchema, c as createInitialState, i as agentCitationSchema, l as runAgentLoop, n as AgentStructuredOutput, o as agentToolCallSchema, r as AgentToolCall, s as createAgent, t as AgentCitation } from "./schemas-Dp_OCqBt.mjs";
+import { n as RiskLevel } from "./schemas-DBOhxgW7.mjs";
+
+//#region src/agents/base/index.d.ts
+declare namespace index_d_exports {
+  export { Agent, AgentCitation, AgentConfig, AgentConfigSchema, AgentContext, AgentExecutionOptions, AgentFactory, AgentMessage, AgentStructuredOutput, AgentToolCall, BaseAgentState, RiskLevel, StopCondition, StopConditions, ToolCallRecord, agentCitationSchema, agentStructuredOutputSchema, agentToolCallSchema, createAgent, createInitialState, runAgentLoop };
+}
+//#endregion
+export { Agent, AgentCitation, AgentConfig, AgentConfigSchema, AgentContext, AgentExecutionOptions, AgentFactory, AgentMessage, AgentStructuredOutput, AgentToolCall, BaseAgentState, RiskLevel, StopCondition, StopConditions, ToolCallRecord, agentCitationSchema, agentStructuredOutputSchema, agentToolCallSchema, createAgent, createInitialState, runAgentLoop, index_d_exports as t };
+//# sourceMappingURL=agents-base.d.mts.map

package/dist/agents-base.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agents-base.d.mts","names":[],"sources":["../src/agents/base/index.ts"],"mappings":""}

package/dist/agents-base.mjs

@@ -0,0 +1,20 @@
+import { t as __exportAll } from "./chunk-CkzbjWQW.mjs";
+import { a as StopConditions, i as AgentConfigSchema, n as createInitialState, r as runAgentLoop, t as createAgent } from "./factory-DP6VSl8C.mjs";
+import "./schemas-CxQtxIga.mjs";
+import { n as agentStructuredOutputSchema, r as agentToolCallSchema, t as agentCitationSchema } from "./schemas-SwCsnT0z.mjs";
+
+//#region src/agents/base/index.ts
+var base_exports = /* @__PURE__ */ __exportAll({
+	AgentConfigSchema: () => AgentConfigSchema,
+	StopConditions: () => StopConditions,
+	agentCitationSchema: () => agentCitationSchema,
+	agentStructuredOutputSchema: () => agentStructuredOutputSchema,
+	agentToolCallSchema: () => agentToolCallSchema,
+	createAgent: () => createAgent,
+	createInitialState: () => createInitialState,
+	runAgentLoop: () => runAgentLoop
+});
+
+//#endregion
+export { AgentConfigSchema, StopConditions, agentCitationSchema, agentStructuredOutputSchema, agentToolCallSchema, createAgent, createInitialState, runAgentLoop, base_exports as t };
+//# sourceMappingURL=agents-base.mjs.map

package/dist/agents-base.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"agents-base.mjs","names":[],"sources":["../src/agents/base/index.ts"],"sourcesContent":["/**\n * @fileoverview Base agent utilities.\n * @module @od-oneapp/ai-platform/agents/base\n */\n\nexport * from './types';\nexport * from './factory';\nexport * from './schemas';\n"],"mappings":""}

package/dist/agents-control-flow.d.mts

@@ -0,0 +1,115 @@
+declare namespace index_d_exports {
+  export { AbortReason, AgentAbortController, AgentAbortError, ContinueCondition, ExecutionController, ExecutionControllerConfig, ExecutionMetrics, StopCondition, StopConditionResult, continueOnAll, continueOnAny, continueWhile, createExecutionController, createExecutionMetrics, createQuickTaskController, createResearchController, createSingleTurnController, maxBudget, maxErrors, maxTokens, maxTurns, stopOnAll, stopOnAny, stopOnTool, stopUnless, stopWhen, timeout, whileNoErrors, whileUnderBudget, whileUnderSteps, whileUnderTokens };
+}
+type AbortReason = 'user_cancel' | 'timeout' | 'max_turns' | 'max_tokens' | 'error_threshold' | 'manual_stop' | 'budget_exceeded' | 'custom';
+interface StopConditionResult {
+  readonly shouldStop: boolean;
+  readonly reason?: AbortReason | string;
+  readonly details?: Record<string, unknown>;
+}
+interface ExecutionMetrics {
+  readonly currentStep: number;
+  readonly totalTokens: number;
+  readonly totalCost: number;
+  readonly errorCount: number;
+  readonly toolCallCount: number;
+  readonly elapsedMs: number;
+  readonly lastToolName?: string;
+  readonly lastToolResult?: unknown;
+  readonly context?: Record<string, unknown>;
+}
+type StopCondition = (state: ExecutionMetrics) => StopConditionResult | boolean;
+type ContinueCondition = (state: ExecutionMetrics) => boolean;
+declare class AgentAbortController {
+  private readonly controller;
+  private abortReason;
+  private abortDetails;
+  private timeoutId;
+  constructor();
+  get signal(): AbortSignal;
+  get aborted(): boolean;
+  get reason(): AbortReason | null;
+  get details(): Record<string, unknown> | null;
+  abort(reason?: AbortReason, details?: Record<string, unknown>): void;
+  setTimeout(ms: number): void;
+  clearTimeout(): void;
+  onAbort(callback: (reason: AbortReason) => void): () => void;
+  throwIfAborted(): void;
+}
+declare class AgentAbortError extends Error {
+  readonly reason: AbortReason;
+  readonly details?: Record<string, unknown>;
+  constructor(reason: AbortReason, details?: Record<string, unknown>);
+  get retryable(): boolean;
+}
+declare function maxTurns(max: number): StopCondition;
+declare function maxTokens(max: number): StopCondition;
+declare function maxBudget(maxCost: number): StopCondition;
+declare function maxErrors(threshold: number): StopCondition;
+declare function timeout(ms: number): StopCondition;
+declare function stopOnTool(toolName: string): StopCondition;
+declare function stopWhen(predicate: (state: ExecutionMetrics) => boolean, reason?: string): StopCondition;
+declare function whileUnderTokens(max: number): ContinueCondition;
+declare function whileUnderBudget(maxCost: number): ContinueCondition;
+declare function whileUnderSteps(max: number): ContinueCondition;
+declare function whileNoErrors(): ContinueCondition;
+declare function continueWhile(predicate: (state: ExecutionMetrics) => boolean): ContinueCondition;
+declare function stopOnAny(...conditions: StopCondition[]): StopCondition;
+declare function stopOnAll(...conditions: StopCondition[]): StopCondition;
+declare function stopUnless(condition: ContinueCondition): StopCondition;
+declare function continueOnAll(...conditions: ContinueCondition[]): ContinueCondition;
+declare function continueOnAny(...conditions: ContinueCondition[]): ContinueCondition;
+interface ExecutionControllerConfig {
+  stopConditions?: StopCondition[];
+  continueConditions?: ContinueCondition[];
+  timeoutMs?: number;
+  maxTurns?: number;
+  maxTokens?: number;
+  maxBudget?: number;
+  maxErrors?: number;
+  onStop?: (result: StopConditionResult) => void;
+  onAbort?: (reason: AbortReason) => void;
+}
+declare class ExecutionController {
+  private abortController;
+  private readonly stopConditions;
+  private readonly continueConditions;
+  private readonly config;
+  private startTime;
+  private lastStopResult;
+  constructor(config?: ExecutionControllerConfig);
+  get signal(): AbortSignal;
+  get aborted(): boolean;
+  get stopResult(): StopConditionResult | null;
+  shouldStop(state: ExecutionMetrics): boolean;
+  shouldContinue(state: ExecutionMetrics): boolean;
+  abort(reason?: AbortReason, details?: Record<string, unknown>): void;
+  reset(): void;
+  getElapsedMs(): number;
+  getRemainingMs(): number | null;
+}
+declare function createExecutionController(config?: ExecutionControllerConfig): ExecutionController;
+declare function createSingleTurnController(): ExecutionController;
+declare function createResearchController(options?: {
+  maxTurns?: number;
+  timeoutMs?: number;
+  maxTokens?: number;
+}): ExecutionController;
+declare function createQuickTaskController(options?: {
+  maxTurns?: number;
+  timeoutMs?: number;
+}): ExecutionController;
+declare function createExecutionMetrics(params: {
+  currentStep: number;
+  totalTokens?: number;
+  totalCost?: number;
+  errorCount?: number;
+  toolCallCount?: number;
+  startTime?: number;
+  lastToolName?: string;
+  lastToolResult?: unknown;
+  context?: Record<string, unknown>;
+}): ExecutionMetrics;
+//#endregion
+export { AbortReason, AgentAbortController, AgentAbortError, ContinueCondition, ExecutionController, ExecutionControllerConfig, ExecutionMetrics, StopCondition, StopConditionResult, continueOnAll, continueOnAny, continueWhile, createExecutionController, createExecutionMetrics, createQuickTaskController, createResearchController, createSingleTurnController, maxBudget, maxErrors, maxTokens, maxTurns, stopOnAll, stopOnAny, stopOnTool, stopUnless, stopWhen, index_d_exports as t, timeout, whileNoErrors, whileUnderBudget, whileUnderSteps, whileUnderTokens };
+//# sourceMappingURL=agents-control-flow.d.mts.map

package/dist/agents-control-flow.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agents-control-flow.d.mts","names":[],"sources":["../src/agents/control-flow/index.ts"],"mappings":"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"}