@namzu/sdk 0.2.0 → 0.4.0

package/dist/store/conversation/memory.js

@@ -1,108 +0,0 @@
-/**
- * @deprecated Use `InMemorySessionStore` from
- * `@namzu/sdk/store/session`. This class implements the deprecated
- * `ConversationStore` contract (thread-scoped, no tenantId) and is kept
- * for one migration window per session-hierarchy.md §13.1; it will be
- * removed in 0.3.0.
- *
- * INTERPRETATION (Phase 3): the old class exposes helpers
- * (`addUserMessage`, `createThread`, `hasThread`, `deleteThread`,
- * `messageCount`, `clear`) that are not part of `ConversationStore` and
- * whose signatures rely on `ThreadId` + `Message` without `TenantId`.
- * Those signatures are structurally incompatible with the new
- * `SessionStore` surface, so a strict alias re-export would lose API
- * (roadmap §2 Phase 3 option (a)). We pick option (b) — retain the
- * original class body verbatim with a deprecation banner — to preserve
- * existing consumers during the migration window without polluting the
- * new `InMemorySessionStore` with thread-scoped helpers.
- */
-import { findSafeTrimIndex } from '../../compaction/dangling.js';
-import { createAssistantMessage, createUserMessage, } from '../../types/message/index.js';
-import { extractFinalResponse } from '../../utils/conversation.js';
-import { generateMessageId } from '../../utils/id.js';
-/**
- * @deprecated See module banner. Use `InMemorySessionStore` from
- * `@namzu/sdk/store/session`.
- */
-export class InMemoryConversationStore {
-    threads = new Map();
-    maxMessages;
-    constructor(config = {}) {
-        this.maxMessages = config.maxMessages ?? 100;
-    }
-    loadMessages(threadId) {
-        const messages = this.threads.get(threadId);
-        if (!messages)
-            return [];
-        // Convert to Message type for trim safety check
-        const convertedMessages = messages.map((m) => {
-            switch (m.role) {
-                case 'user':
-                    return createUserMessage(m.content);
-                case 'assistant':
-                    return createAssistantMessage(m.content);
-                default: {
-                    const _exhaustive = m.role;
-                    throw new Error(`Unhandled message role: ${_exhaustive}`);
-                }
-            }
-        });
-        // Apply safe trimming to preserve tool call/result atomicity
-        let trimStartIdx = 0;
-        if (convertedMessages.length > this.maxMessages) {
-            const desiredTrimPoint = convertedMessages.length - this.maxMessages;
-            trimStartIdx = findSafeTrimIndex(convertedMessages, desiredTrimPoint);
-        }
-        return convertedMessages.slice(trimStartIdx);
-    }
-    persistRunResult(threadId, runId, messages) {
-        const finalAssistant = extractFinalResponse(messages);
-        if (!finalAssistant || !finalAssistant.content)
-            return;
-        this.ensureThread(threadId);
-        this.threads.get(threadId)?.push({
-            id: generateMessageId(),
-            threadId,
-            role: 'assistant',
-            content: finalAssistant.content,
-            runId,
-            createdAt: new Date().toISOString(),
-        });
-    }
-    addUserMessage(threadId, content) {
-        this.ensureThread(threadId);
-        const id = generateMessageId();
-        this.threads.get(threadId)?.push({
-            id,
-            threadId,
-            role: 'user',
-            content,
-            createdAt: new Date().toISOString(),
-        });
-        return id;
-    }
-    hasThread(threadId) {
-        return this.threads.has(threadId);
-    }
-    createThread(threadId) {
-        if (this.threads.has(threadId))
-            return false;
-        this.threads.set(threadId, []);
-        return true;
-    }
-    deleteThread(threadId) {
-        return this.threads.delete(threadId);
-    }
-    messageCount(threadId) {
-        return this.threads.get(threadId)?.length ?? 0;
-    }
-    clear() {
-        this.threads.clear();
-    }
-    ensureThread(threadId) {
-        if (!this.threads.has(threadId)) {
-            this.threads.set(threadId, []);
-        }
-    }
-}
-//# sourceMappingURL=memory.js.map

package/dist/store/conversation/memory.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"memory.js","sourceRoot":"","sources":["../../../src/store/conversation/memory.ts"],"names":[],"mappings":"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"}

package/dist/telemetry/index.d.ts

@@ -1,6 +0,0 @@
-export { TelemetryProvider, initTelemetry, getTelemetry, getTracer, getMeter, } from '../provider/telemetry/setup.js';
-export type { TelemetryConfig, ExporterType } from '../types/telemetry/index.js';
-export { createPlatformMetrics } from './metrics.js';
-export type { PlatformMetrics } from './metrics.js';
-export * from './attributes.js';
-//# sourceMappingURL=index.d.ts.map

package/dist/telemetry/index.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/telemetry/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACN,iBAAiB,EACjB,aAAa,EACb,YAAY,EACZ,SAAS,EACT,QAAQ,GACR,MAAM,gCAAgC,CAAA;AAEvC,YAAY,EAAE,eAAe,EAAE,YAAY,EAAE,MAAM,6BAA6B,CAAA;AAEhF,OAAO,EAAE,qBAAqB,EAAE,MAAM,cAAc,CAAA;AACpD,YAAY,EAAE,eAAe,EAAE,MAAM,cAAc,CAAA;AAEnD,cAAc,iBAAiB,CAAA"}

package/dist/telemetry/index.js

@@ -1,4 +0,0 @@
-export { TelemetryProvider, initTelemetry, getTelemetry, getTracer, getMeter, } from '../provider/telemetry/setup.js';
-export { createPlatformMetrics } from './metrics.js';
-export * from './attributes.js';
-//# sourceMappingURL=index.js.map

package/dist/telemetry/index.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/telemetry/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACN,iBAAiB,EACjB,aAAa,EACb,YAAY,EACZ,SAAS,EACT,QAAQ,GACR,MAAM,gCAAgC,CAAA;AAIvC,OAAO,EAAE,qBAAqB,EAAE,MAAM,cAAc,CAAA;AAGpD,cAAc,iBAAiB,CAAA"}

package/dist/telemetry/metrics.d.ts

@@ -1,8 +0,0 @@
-export interface PlatformMetrics {
-    recordTokenUsage(model: string, inputTokens: number, outputTokens: number): void;
-    recordToolCall(toolName: string, success: boolean): void;
-    recordRunDuration(status: string, durationSec: number): void;
-    recordLLMLatency(model: string, durationSec: number): void;
-}
-export declare function createPlatformMetrics(): PlatformMetrics;
-//# sourceMappingURL=metrics.d.ts.map

package/dist/telemetry/metrics.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"metrics.d.ts","sourceRoot":"","sources":["../../src/telemetry/metrics.ts"],"names":[],"mappings":"AAEA,MAAM,WAAW,eAAe;IAC/B,gBAAgB,CAAC,KAAK,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,GAAG,IAAI,CAAA;IAChF,cAAc,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,GAAG,IAAI,CAAA;IACxD,iBAAiB,CAAC,MAAM,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,IAAI,CAAA;IAC5D,gBAAgB,CAAC,KAAK,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,IAAI,CAAA;CAC1D;AAED,wBAAgB,qBAAqB,IAAI,eAAe,CA2DvD"}

package/dist/telemetry/metrics.js

@@ -1,53 +0,0 @@
-import { getMeter } from '../provider/telemetry/setup.js';
-export function createPlatformMetrics() {
-    const meter = getMeter();
-    const tokenInputCounter = meter.createCounter('gen_ai.client.token.usage', {
-        description: 'Number of input (prompt) tokens used',
-        unit: '{token}',
-    });
-    const tokenOutputCounter = meter.createCounter('gen_ai.client.token.usage.output', {
-        description: 'Number of output (completion) tokens used',
-        unit: '{token}',
-    });
-    const toolCallCounter = meter.createCounter('gen_ai.tool.call.count', {
-        description: 'Number of tool calls executed',
-        unit: '{call}',
-    });
-    const runDurationHistogram = meter.createHistogram('namzu.run.duration', {
-        description: 'Agent run duration',
-        unit: 's',
-    });
-    const llmLatencyHistogram = meter.createHistogram('gen_ai.client.operation.duration', {
-        description: 'LLM request duration (GenAI semantic convention)',
-        unit: 's',
-    });
-    return {
-        recordTokenUsage(model, inputTokens, outputTokens) {
-            tokenInputCounter.add(inputTokens, {
-                'gen_ai.request.model': model,
-                'gen_ai.token.type': 'input',
-            });
-            tokenOutputCounter.add(outputTokens, {
-                'gen_ai.request.model': model,
-                'gen_ai.token.type': 'output',
-            });
-        },
-        recordToolCall(toolName, success) {
-            toolCallCounter.add(1, {
-                'gen_ai.tool.name': toolName,
-                'namzu.tool.success': success,
-            });
-        },
-        recordRunDuration(status, durationSec) {
-            runDurationHistogram.record(durationSec, {
-                'namzu.run.status': status,
-            });
-        },
-        recordLLMLatency(model, durationSec) {
-            llmLatencyHistogram.record(durationSec, {
-                'gen_ai.request.model': model,
-            });
-        },
-    };
-}
-//# sourceMappingURL=metrics.js.map

package/dist/telemetry/metrics.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"metrics.js","sourceRoot":"","sources":["../../src/telemetry/metrics.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,gCAAgC,CAAA;AASzD,MAAM,UAAU,qBAAqB;IACpC,MAAM,KAAK,GAAG,QAAQ,EAAE,CAAA;IAExB,MAAM,iBAAiB,GAAG,KAAK,CAAC,aAAa,CAAC,2BAA2B,EAAE;QAC1E,WAAW,EAAE,sCAAsC;QACnD,IAAI,EAAE,SAAS;KACf,CAAC,CAAA;IAEF,MAAM,kBAAkB,GAAG,KAAK,CAAC,aAAa,CAAC,kCAAkC,EAAE;QAClF,WAAW,EAAE,2CAA2C;QACxD,IAAI,EAAE,SAAS;KACf,CAAC,CAAA;IAEF,MAAM,eAAe,GAAG,KAAK,CAAC,aAAa,CAAC,wBAAwB,EAAE;QACrE,WAAW,EAAE,+BAA+B;QAC5C,IAAI,EAAE,QAAQ;KACd,CAAC,CAAA;IAEF,MAAM,oBAAoB,GAAG,KAAK,CAAC,eAAe,CAAC,oBAAoB,EAAE;QACxE,WAAW,EAAE,oBAAoB;QACjC,IAAI,EAAE,GAAG;KACT,CAAC,CAAA;IAEF,MAAM,mBAAmB,GAAG,KAAK,CAAC,eAAe,CAAC,kCAAkC,EAAE;QACrF,WAAW,EAAE,kDAAkD;QAC/D,IAAI,EAAE,GAAG;KACT,CAAC,CAAA;IAEF,OAAO;QACN,gBAAgB,CAAC,KAAa,EAAE,WAAmB,EAAE,YAAoB;YACxE,iBAAiB,CAAC,GAAG,CAAC,WAAW,EAAE;gBAClC,sBAAsB,EAAE,KAAK;gBAC7B,mBAAmB,EAAE,OAAO;aAC5B,CAAC,CAAA;YACF,kBAAkB,CAAC,GAAG,CAAC,YAAY,EAAE;gBACpC,sBAAsB,EAAE,KAAK;gBAC7B,mBAAmB,EAAE,QAAQ;aAC7B,CAAC,CAAA;QACH,CAAC;QAED,cAAc,CAAC,QAAgB,EAAE,OAAgB;YAChD,eAAe,CAAC,GAAG,CAAC,CAAC,EAAE;gBACtB,kBAAkB,EAAE,QAAQ;gBAC5B,oBAAoB,EAAE,OAAO;aAC7B,CAAC,CAAA;QACH,CAAC;QAED,iBAAiB,CAAC,MAAc,EAAE,WAAmB;YACpD,oBAAoB,CAAC,MAAM,CAAC,WAAW,EAAE;gBACxC,kBAAkB,EAAE,MAAM;aAC1B,CAAC,CAAA;QACH,CAAC;QAED,gBAAgB,CAAC,KAAa,EAAE,WAAmB;YAClD,mBAAmB,CAAC,MAAM,CAAC,WAAW,EAAE;gBACvC,sBAAsB,EAAE,KAAK;aAC7B,CAAC,CAAA;QACH,CAAC;KACD,CAAA;AACF,CAAC"}

package/dist/types/conversation/index.d.ts

@@ -1,14 +0,0 @@
-import type { RunId, ThreadId } from '../ids/index.js';
-import type { Message } from '../message/index.js';
-/**
- * @deprecated Use `SessionStore` from `@namzu/sdk` (import via
- * `types/session/store.ts` or the root barrel). `ConversationStore` is
- * thread-scoped and does not carry the `tenantId` required by
- * session-hierarchy.md §12.1. Scheduled for removal in 0.3.0; the one-
- * version migration window follows session-hierarchy.md §13.1.
- */
-export interface ConversationStore {
-    loadMessages(threadId: ThreadId): Message[];
-    persistRunResult(threadId: ThreadId, runId: RunId, messages: Message[]): void;
-}
-//# sourceMappingURL=index.d.ts.map

package/dist/types/conversation/index.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/types/conversation/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAE,QAAQ,EAAE,MAAM,iBAAiB,CAAA;AACtD,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAA;AAElD;;;;;;GAMG;AACH,MAAM,WAAW,iBAAiB;IACjC,YAAY,CAAC,QAAQ,EAAE,QAAQ,GAAG,OAAO,EAAE,CAAA;IAE3C,gBAAgB,CAAC,QAAQ,EAAE,QAAQ,EAAE,KAAK,EAAE,KAAK,EAAE,QAAQ,EAAE,OAAO,EAAE,GAAG,IAAI,CAAA;CAC7E"}

package/dist/types/conversation/index.js

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

package/dist/types/conversation/index.js.map

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

package/dist/types/telemetry/index.d.ts

@@ -1,10 +0,0 @@
-export type ExporterType = 'console' | 'otlp' | 'none';
-export interface TelemetryConfig {
-    serviceName: string;
-    serviceVersion?: string;
-    exporterType: ExporterType;
-    otlpEndpoint?: string;
-    otlpHeaders?: Record<string, string>;
-    metricExportIntervalMs?: number;
-}
-//# sourceMappingURL=index.d.ts.map

package/dist/types/telemetry/index.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/types/telemetry/index.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,YAAY,GAAG,SAAS,GAAG,MAAM,GAAG,MAAM,CAAA;AAEtD,MAAM,WAAW,eAAe;IAC/B,WAAW,EAAE,MAAM,CAAA;IACnB,cAAc,CAAC,EAAE,MAAM,CAAA;IACvB,YAAY,EAAE,YAAY,CAAA;IAC1B,YAAY,CAAC,EAAE,MAAM,CAAA;IACrB,WAAW,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;IACpC,sBAAsB,CAAC,EAAE,MAAM,CAAA;CAC/B"}

package/dist/types/telemetry/index.js

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

package/dist/types/telemetry/index.js.map

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

package/src/provider/telemetry/setup.ts

@@ -1,125 +0,0 @@
-import { type Meter, type Tracer, metrics, trace } from '@opentelemetry/api'
-import { OTLPMetricExporter } from '@opentelemetry/exporter-metrics-otlp-http'
-import { OTLPTraceExporter } from '@opentelemetry/exporter-trace-otlp-http'
-import { Resource } from '@opentelemetry/resources'
-import {
-	ConsoleMetricExporter,
-	MeterProvider,
-	PeriodicExportingMetricReader,
-} from '@opentelemetry/sdk-metrics'
-import { NodeSDK } from '@opentelemetry/sdk-node'
-import { ConsoleSpanExporter, SimpleSpanProcessor } from '@opentelemetry/sdk-trace-node'
-import type { TelemetryConfig } from '../../types/telemetry/index.js'
-import { toErrorMessage } from '../../utils/error.js'
-import { getRootLogger } from '../../utils/logger.js'
-import { VERSION } from '../../version.js'
-
-const logger = getRootLogger().child({ component: 'TelemetryProvider' })
-
-export class TelemetryProvider {
-	private sdk: NodeSDK | null = null
-	private meterProvider: MeterProvider | null = null
-	private config: TelemetryConfig
-	private _tracer: Tracer | null = null
-	private _meter: Meter | null = null
-
-	constructor(config: TelemetryConfig) {
-		this.config = config
-	}
-
-	get tracer(): Tracer {
-		if (!this._tracer) {
-			this._tracer = trace.getTracer(this.config.serviceName, this.config.serviceVersion ?? VERSION)
-		}
-		return this._tracer
-	}
-
-	get meter(): Meter {
-		if (!this._meter) {
-			this._meter = metrics.getMeter(this.config.serviceName, this.config.serviceVersion ?? VERSION)
-		}
-		return this._meter
-	}
-
-	async start(): Promise<void> {
-		if (this.config.exporterType === 'none') {
-			logger.info('Telemetry disabled (exporterType=none)')
-			return
-		}
-
-		const resource = new Resource({
-			'service.name': this.config.serviceName,
-			'service.version': this.config.serviceVersion ?? VERSION,
-		})
-
-		const traceExporter =
-			this.config.exporterType === 'otlp'
-				? new OTLPTraceExporter({
-						url: this.config.otlpEndpoint ? `${this.config.otlpEndpoint}/v1/traces` : undefined,
-						headers: this.config.otlpHeaders,
-					})
-				: new ConsoleSpanExporter()
-
-		const metricExporter =
-			this.config.exporterType === 'otlp'
-				? new OTLPMetricExporter({
-						url: this.config.otlpEndpoint ? `${this.config.otlpEndpoint}/v1/metrics` : undefined,
-						headers: this.config.otlpHeaders,
-					})
-				: new ConsoleMetricExporter()
-
-		this.meterProvider = new MeterProvider({
-			resource,
-			readers: [
-				new PeriodicExportingMetricReader({
-					exporter: metricExporter,
-					exportIntervalMillis: this.config.metricExportIntervalMs ?? 10_000,
-				}),
-			],
-		})
-		metrics.setGlobalMeterProvider(this.meterProvider)
-
-		this.sdk = new NodeSDK({
-			resource,
-			spanProcessor: new SimpleSpanProcessor(traceExporter),
-		})
-
-		this.sdk.start()
-		logger.info(`Telemetry started (exporter=${this.config.exporterType})`)
-	}
-
-	async shutdown(): Promise<void> {
-		try {
-			if (this.meterProvider) {
-				await this.meterProvider.shutdown()
-			}
-			if (this.sdk) {
-				await this.sdk.shutdown()
-			}
-			logger.info('Telemetry shutdown complete')
-		} catch (err) {
-			logger.error('Telemetry shutdown error', {
-				error: toErrorMessage(err),
-			})
-		}
-	}
-}
-
-let _globalProvider: TelemetryProvider | null = null
-
-export function initTelemetry(config: TelemetryConfig): TelemetryProvider {
-	_globalProvider = new TelemetryProvider(config)
-	return _globalProvider
-}
-
-export function getTelemetry(): TelemetryProvider | null {
-	return _globalProvider
-}
-
-export function getTracer(): Tracer {
-	return _globalProvider?.tracer ?? trace.getTracer('namzu')
-}
-
-export function getMeter(): Meter {
-	return _globalProvider?.meter ?? metrics.getMeter('namzu')
-}

package/src/store/conversation/memory.ts

@@ -1,144 +0,0 @@
-/**
- * @deprecated Use `InMemorySessionStore` from
- * `@namzu/sdk/store/session`. This class implements the deprecated
- * `ConversationStore` contract (thread-scoped, no tenantId) and is kept
- * for one migration window per session-hierarchy.md §13.1; it will be
- * removed in 0.3.0.
- *
- * INTERPRETATION (Phase 3): the old class exposes helpers
- * (`addUserMessage`, `createThread`, `hasThread`, `deleteThread`,
- * `messageCount`, `clear`) that are not part of `ConversationStore` and
- * whose signatures rely on `ThreadId` + `Message` without `TenantId`.
- * Those signatures are structurally incompatible with the new
- * `SessionStore` surface, so a strict alias re-export would lose API
- * (roadmap §2 Phase 3 option (a)). We pick option (b) — retain the
- * original class body verbatim with a deprecation banner — to preserve
- * existing consumers during the migration window without polluting the
- * new `InMemorySessionStore` with thread-scoped helpers.
- */
-
-import { findSafeTrimIndex } from '../../compaction/dangling.js'
-import type { ConversationStore } from '../../types/conversation/index.js'
-import type { MessageId, RunId, ThreadId } from '../../types/ids/index.js'
-import {
-	type Message,
-	createAssistantMessage,
-	createUserMessage,
-} from '../../types/message/index.js'
-import { extractFinalResponse } from '../../utils/conversation.js'
-import { generateMessageId } from '../../utils/id.js'
-
-interface ConversationMessage {
-	readonly id: MessageId
-
-	readonly threadId: ThreadId
-
-	readonly role: 'user' | 'assistant'
-
-	readonly content: string
-
-	readonly runId?: RunId
-
-	readonly createdAt: string
-}
-
-export interface InMemoryConversationStoreConfig {
-	readonly maxMessages?: number
-}
-
-/**
- * @deprecated See module banner. Use `InMemorySessionStore` from
- * `@namzu/sdk/store/session`.
- */
-export class InMemoryConversationStore implements ConversationStore {
-	private readonly threads = new Map<ThreadId, ConversationMessage[]>()
-	private readonly maxMessages: number
-
-	constructor(config: InMemoryConversationStoreConfig = {}) {
-		this.maxMessages = config.maxMessages ?? 100
-	}
-
-	loadMessages(threadId: ThreadId): Message[] {
-		const messages = this.threads.get(threadId)
-		if (!messages) return []
-
-		// Convert to Message type for trim safety check
-		const convertedMessages: Message[] = messages.map((m) => {
-			switch (m.role) {
-				case 'user':
-					return createUserMessage(m.content)
-				case 'assistant':
-					return createAssistantMessage(m.content)
-				default: {
-					const _exhaustive: never = m.role
-					throw new Error(`Unhandled message role: ${_exhaustive}`)
-				}
-			}
-		})
-
-		// Apply safe trimming to preserve tool call/result atomicity
-		let trimStartIdx = 0
-		if (convertedMessages.length > this.maxMessages) {
-			const desiredTrimPoint = convertedMessages.length - this.maxMessages
-			trimStartIdx = findSafeTrimIndex(convertedMessages, desiredTrimPoint)
-		}
-
-		return convertedMessages.slice(trimStartIdx)
-	}
-
-	persistRunResult(threadId: ThreadId, runId: RunId, messages: Message[]): void {
-		const finalAssistant = extractFinalResponse(messages)
-		if (!finalAssistant || !finalAssistant.content) return
-
-		this.ensureThread(threadId)
-		this.threads.get(threadId)?.push({
-			id: generateMessageId(),
-			threadId,
-			role: 'assistant',
-			content: finalAssistant.content,
-			runId,
-			createdAt: new Date().toISOString(),
-		})
-	}
-
-	addUserMessage(threadId: ThreadId, content: string): MessageId {
-		this.ensureThread(threadId)
-		const id = generateMessageId()
-		this.threads.get(threadId)?.push({
-			id,
-			threadId,
-			role: 'user',
-			content,
-			createdAt: new Date().toISOString(),
-		})
-		return id
-	}
-
-	hasThread(threadId: ThreadId): boolean {
-		return this.threads.has(threadId)
-	}
-
-	createThread(threadId: ThreadId): boolean {
-		if (this.threads.has(threadId)) return false
-		this.threads.set(threadId, [])
-		return true
-	}
-
-	deleteThread(threadId: ThreadId): boolean {
-		return this.threads.delete(threadId)
-	}
-
-	messageCount(threadId: ThreadId): number {
-		return this.threads.get(threadId)?.length ?? 0
-	}
-
-	clear(): void {
-		this.threads.clear()
-	}
-
-	private ensureThread(threadId: ThreadId): void {
-		if (!this.threads.has(threadId)) {
-			this.threads.set(threadId, [])
-		}
-	}
-}

package/src/telemetry/index.ts

@@ -1,14 +0,0 @@
-export {
-	TelemetryProvider,
-	initTelemetry,
-	getTelemetry,
-	getTracer,
-	getMeter,
-} from '../provider/telemetry/setup.js'
-
-export type { TelemetryConfig, ExporterType } from '../types/telemetry/index.js'
-
-export { createPlatformMetrics } from './metrics.js'
-export type { PlatformMetrics } from './metrics.js'
-
-export * from './attributes.js'

package/src/telemetry/metrics.ts

@@ -1,69 +0,0 @@
-import { getMeter } from '../provider/telemetry/setup.js'
-
-export interface PlatformMetrics {
-	recordTokenUsage(model: string, inputTokens: number, outputTokens: number): void
-	recordToolCall(toolName: string, success: boolean): void
-	recordRunDuration(status: string, durationSec: number): void
-	recordLLMLatency(model: string, durationSec: number): void
-}
-
-export function createPlatformMetrics(): PlatformMetrics {
-	const meter = getMeter()
-
-	const tokenInputCounter = meter.createCounter('gen_ai.client.token.usage', {
-		description: 'Number of input (prompt) tokens used',
-		unit: '{token}',
-	})
-
-	const tokenOutputCounter = meter.createCounter('gen_ai.client.token.usage.output', {
-		description: 'Number of output (completion) tokens used',
-		unit: '{token}',
-	})
-
-	const toolCallCounter = meter.createCounter('gen_ai.tool.call.count', {
-		description: 'Number of tool calls executed',
-		unit: '{call}',
-	})
-
-	const runDurationHistogram = meter.createHistogram('namzu.run.duration', {
-		description: 'Agent run duration',
-		unit: 's',
-	})
-
-	const llmLatencyHistogram = meter.createHistogram('gen_ai.client.operation.duration', {
-		description: 'LLM request duration (GenAI semantic convention)',
-		unit: 's',
-	})
-
-	return {
-		recordTokenUsage(model: string, inputTokens: number, outputTokens: number): void {
-			tokenInputCounter.add(inputTokens, {
-				'gen_ai.request.model': model,
-				'gen_ai.token.type': 'input',
-			})
-			tokenOutputCounter.add(outputTokens, {
-				'gen_ai.request.model': model,
-				'gen_ai.token.type': 'output',
-			})
-		},
-
-		recordToolCall(toolName: string, success: boolean): void {
-			toolCallCounter.add(1, {
-				'gen_ai.tool.name': toolName,
-				'namzu.tool.success': success,
-			})
-		},
-
-		recordRunDuration(status: string, durationSec: number): void {
-			runDurationHistogram.record(durationSec, {
-				'namzu.run.status': status,
-			})
-		},
-
-		recordLLMLatency(model: string, durationSec: number): void {
-			llmLatencyHistogram.record(durationSec, {
-				'gen_ai.request.model': model,
-			})
-		},
-	}
-}

package/src/types/conversation/index.ts

@@ -1,15 +0,0 @@
-import type { RunId, ThreadId } from '../ids/index.js'
-import type { Message } from '../message/index.js'
-
-/**
- * @deprecated Use `SessionStore` from `@namzu/sdk` (import via
- * `types/session/store.ts` or the root barrel). `ConversationStore` is
- * thread-scoped and does not carry the `tenantId` required by
- * session-hierarchy.md §12.1. Scheduled for removal in 0.3.0; the one-
- * version migration window follows session-hierarchy.md §13.1.
- */
-export interface ConversationStore {
-	loadMessages(threadId: ThreadId): Message[]
-
-	persistRunResult(threadId: ThreadId, runId: RunId, messages: Message[]): void
-}

package/src/types/telemetry/index.ts

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