@itaila/archetype 0.3.30

package/dist/providers/zod-to-gemini.js

@@ -0,0 +1,148 @@
+import { SchemaType } from '@google/generative-ai';
+/**
+ * Resolve the type identifier from a Zod schema.
+ * Zod v3 uses `_def.typeName` ("ZodString"), v4 uses `_def.type` ("string").
+ */
+function resolveTypeName(def) {
+    // v3: _def.typeName = "ZodString" | "ZodObject" | ...
+    if (typeof def.typeName === 'string')
+        return def.typeName;
+    // v4: _def.type = "string" | "object" | ... — normalize to v3 style
+    if (typeof def.type === 'string') {
+        const map = {
+            string: 'ZodString', number: 'ZodNumber', boolean: 'ZodBoolean',
+            array: 'ZodArray', object: 'ZodObject', optional: 'ZodOptional',
+            nullable: 'ZodNullable', enum: 'ZodEnum', literal: 'ZodLiteral',
+        };
+        return map[def.type] ?? '';
+    }
+    return '';
+}
+/**
+ * Get the inner object shape from a Zod schema (v3 uses function, v4 uses plain object).
+ */
+function resolveShape(def) {
+    const s = def.shape;
+    if (typeof s === 'function')
+        return s();
+    if (s && typeof s === 'object')
+        return s;
+    return null;
+}
+/**
+ * Get the array item type (v3: _def.type, v4: _def.element).
+ */
+function resolveArrayItem(def) {
+    // v3: _def.type is the ZodType for array items
+    if (def.type && typeof def.type === 'object' && '_def' in def.type) {
+        return def.type;
+    }
+    // v4: _def.element is the item type
+    if (def.element && typeof def.element === 'object' && '_def' in def.element) {
+        return def.element;
+    }
+    return null;
+}
+/**
+ * Get the inner type for optional/nullable (v3: _def.innerType, v4: _def.innerType).
+ */
+function resolveInnerType(def) {
+    const inner = def.innerType;
+    if (inner && typeof inner === 'object' && '_def' in inner)
+        return inner;
+    return null;
+}
+/**
+ * Convert a Zod schema to a Gemini-compatible schema object.
+ * Supports both Zod v3 (typeName) and v4 (type string + element/shape).
+ * Falls back to STRING for unknown types (safe default — model will parse from text).
+ */
+export function zodToGeminiSchema(zodType) {
+    const def = zodType._def;
+    const typeName = resolveTypeName(def);
+    const description = def.description
+        ?? zodType.description;
+    let result;
+    switch (typeName) {
+        case 'ZodString':
+            result = { type: SchemaType.STRING };
+            break;
+        case 'ZodNumber':
+            result = { type: SchemaType.NUMBER };
+            break;
+        case 'ZodBoolean':
+            result = { type: SchemaType.BOOLEAN };
+            break;
+        case 'ZodEnum': {
+            const values = def.values ?? def.entries;
+            result = { type: SchemaType.STRING, enum: Array.isArray(values) ? values : Object.keys(values) };
+            break;
+        }
+        case 'ZodLiteral':
+            result = { type: SchemaType.STRING, enum: [String(def.value)] };
+            break;
+        case 'ZodArray': {
+            const item = resolveArrayItem(def);
+            result = item
+                ? { type: SchemaType.ARRAY, items: zodToGeminiSchema(item) }
+                : { type: SchemaType.ARRAY, items: { type: SchemaType.STRING } };
+            break;
+        }
+        case 'ZodObject': {
+            const shape = resolveShape(def);
+            if (!shape) {
+                result = { type: SchemaType.OBJECT, properties: {} };
+                break;
+            }
+            const properties = {};
+            const required = [];
+            for (const [key, value] of Object.entries(shape)) {
+                const innerDef = value._def;
+                const innerTypeName = resolveTypeName(innerDef);
+                if (innerTypeName === 'ZodOptional') {
+                    properties[key] = zodToGeminiSchema(value);
+                }
+                else {
+                    properties[key] = zodToGeminiSchema(value);
+                    required.push(key);
+                }
+            }
+            result = {
+                type: SchemaType.OBJECT,
+                properties,
+                ...(required.length > 0 ? { required } : {}),
+            };
+            break;
+        }
+        case 'ZodOptional': {
+            const inner = resolveInnerType(def);
+            if (!inner) {
+                result = { type: SchemaType.STRING };
+                break;
+            }
+            const innerSchema = zodToGeminiSchema(inner);
+            if (description && !innerSchema.description) {
+                return { ...innerSchema, description };
+            }
+            return innerSchema;
+        }
+        case 'ZodNullable': {
+            const inner = resolveInnerType(def);
+            if (!inner) {
+                result = { type: SchemaType.STRING, nullable: true };
+                break;
+            }
+            const innerSchema = zodToGeminiSchema(inner);
+            return { ...innerSchema, nullable: true, ...(description && !innerSchema.description ? { description } : {}) };
+        }
+        default:
+            // Safe fallback — model will parse from the text description
+            result = { type: SchemaType.STRING };
+            break;
+    }
+    if (description) {
+        result.description = description;
+    }
+    return result;
+}
+//# sourceMappingURL=zod-to-gemini.js.map

package/dist/providers/zod-to-gemini.js.map

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

package/dist/samples/pm-spec-agent.d.ts

@@ -0,0 +1,22 @@
+import type { LLMProvider, PersonaConfig } from '../types.js';
+export interface PmSpecPersonaOptions {
+    provider: LLMProvider;
+}
+/**
+ * Sample PM persona for focus-mode spec work.
+ *
+ * This is intentionally a sample, not a new framework. It demonstrates the
+ * Archetype primitives that should generalize to every tool-using persona:
+ * an optional durable work item, chronological work history, factual file state, and
+ * outcome-aware file actions.
+ */
+export declare function createPmSpecPersonaConfig(options: PmSpecPersonaOptions): PersonaConfig;
+export declare const pmSpecContextInputs: PersonaConfig['contextInputs'];
+export declare function createPmSpecWorkItem(input: {
+    artifactName: string;
+    primaryGoal: string;
+    constraints: string[];
+    mandatoryOutputs: string[];
+    followUpAssignment?: string;
+}): string;
+//# sourceMappingURL=pm-spec-agent.d.ts.map

package/dist/samples/pm-spec-agent.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pm-spec-agent.d.ts","sourceRoot":"","sources":["../../src/samples/pm-spec-agent.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,aAAa,EAAE,MAAM,aAAa,CAAA;AAI7D,MAAM,WAAW,oBAAoB;IACnC,QAAQ,EAAE,WAAW,CAAA;CACtB;AAED;;;;;;;GAOG;AACH,wBAAgB,yBAAyB,CAAC,OAAO,EAAE,oBAAoB,GAAG,aAAa,CA+BtF;AAED,eAAO,MAAM,mBAAmB,EAAE,aAAa,CAAC,eAAe,CAA6B,CAAA;AAE5F,wBAAgB,oBAAoB,CAAC,KAAK,EAAE;IAC1C,YAAY,EAAE,MAAM,CAAA;IACpB,WAAW,EAAE,MAAM,CAAA;IACnB,WAAW,EAAE,MAAM,EAAE,CAAA;IACrB,gBAAgB,EAAE,MAAM,EAAE,CAAA;IAC1B,kBAAkB,CAAC,EAAE,MAAM,CAAA;CAC5B,GAAG,MAAM,CAQT"}

package/dist/samples/pm-spec-agent.js

@@ -0,0 +1,53 @@
+import { coderActions } from '../builder/actions.js';
+import { buildFocusContextInputs, renderFocusWorkItem } from '../core/focus-context.js';
+/**
+ * Sample PM persona for focus-mode spec work.
+ *
+ * This is intentionally a sample, not a new framework. It demonstrates the
+ * Archetype primitives that should generalize to every tool-using persona:
+ * an optional durable work item, chronological work history, factual file state, and
+ * outcome-aware file actions.
+ */
+export function createPmSpecPersonaConfig(options) {
+    return {
+        identity: {
+            name: 'Product Manager',
+            expertise: ['product strategy', 'spec writing', 'scope control', 'engineering handoff'],
+            relationship: 'focused specification partner',
+            northStar: 'produce a coherent spec bundle that lets engineering start without a rescue meeting',
+        },
+        voice: {
+            tone: 'direct',
+            style: 'quick',
+            medium: 'desktop-panel',
+        },
+        directives: {
+            default: [
+                'You prepare implementation-ready specs by writing directly to files.',
+                'Ground the files in concrete product decisions, scope boundaries, system behavior, and engineering handoff details.',
+                'When the work item changes after a completed pass, treat it as a follow-up assignment and update the bundle coherently across documents.',
+            ].join(' '),
+        },
+        contextInputs: pmSpecContextInputs,
+        actions: {
+            readFile: coderActions.readFile,
+            applyPatch: coderActions.applyPatch,
+            listFiles: coderActions.listFiles,
+            searchInFiles: coderActions.searchInFiles,
+            returnToSession: coderActions.returnToSession,
+            finishAttempt: coderActions.finishAttempt,
+        },
+        provider: options.provider,
+    };
+}
+export const pmSpecContextInputs = buildFocusContextInputs();
+export function createPmSpecWorkItem(input) {
+    return renderFocusWorkItem({
+        artifactName: input.artifactName,
+        primaryGoal: input.primaryGoal,
+        constraints: input.constraints,
+        mandatoryOutputs: input.mandatoryOutputs,
+        followUpAssignment: input.followUpAssignment,
+    });
+}
+//# sourceMappingURL=pm-spec-agent.js.map

package/dist/samples/pm-spec-agent.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"pm-spec-agent.js","sourceRoot":"","sources":["../../src/samples/pm-spec-agent.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAA;AACpD,OAAO,EAAE,uBAAuB,EAAE,mBAAmB,EAAE,MAAM,0BAA0B,CAAA;AAMvF;;;;;;;GAOG;AACH,MAAM,UAAU,yBAAyB,CAAC,OAA6B;IACrE,OAAO;QACL,QAAQ,EAAE;YACR,IAAI,EAAE,iBAAiB;YACvB,SAAS,EAAE,CAAC,kBAAkB,EAAE,cAAc,EAAE,eAAe,EAAE,qBAAqB,CAAC;YACvF,YAAY,EAAE,+BAA+B;YAC7C,SAAS,EAAE,qFAAqF;SACjG;QACD,KAAK,EAAE;YACL,IAAI,EAAE,QAAQ;YACd,KAAK,EAAE,OAAO;YACd,MAAM,EAAE,eAAe;SACxB;QACD,UAAU,EAAE;YACV,OAAO,EAAE;gBACP,sEAAsE;gBACtE,qHAAqH;gBACrH,0IAA0I;aAC3I,CAAC,IAAI,CAAC,GAAG,CAAC;SACZ;QACD,aAAa,EAAE,mBAAmB;QAClC,OAAO,EAAE;YACP,QAAQ,EAAE,YAAY,CAAC,QAAQ;YAC/B,UAAU,EAAE,YAAY,CAAC,UAAU;YACnC,SAAS,EAAE,YAAY,CAAC,SAAS;YACjC,aAAa,EAAE,YAAY,CAAC,aAAa;YACzC,eAAe,EAAE,YAAY,CAAC,eAAe;YAC7C,aAAa,EAAE,YAAY,CAAC,aAAa;SAC1C;QACD,QAAQ,EAAE,OAAO,CAAC,QAAQ;KAC3B,CAAA;AACH,CAAC;AAED,MAAM,CAAC,MAAM,mBAAmB,GAAmC,uBAAuB,EAAE,CAAA;AAE5F,MAAM,UAAU,oBAAoB,CAAC,KAMpC;IACC,OAAO,mBAAmB,CAAC;QACzB,YAAY,EAAE,KAAK,CAAC,YAAY;QAChC,WAAW,EAAE,KAAK,CAAC,WAAW;QAC9B,WAAW,EAAE,KAAK,CAAC,WAAW;QAC9B,gBAAgB,EAAE,KAAK,CAAC,gBAAgB;QACxC,kBAAkB,EAAE,KAAK,CAAC,kBAAkB;KAC7C,CAAC,CAAA;AACJ,CAAC"}