@helmiq/crew 0.1.0

package/dist/types/artifact-store.js

@@ -0,0 +1,9 @@
+/**
+ * Abstract artifact store interface.
+ *
+ * Provides CRUD operations for delivery artifacts (requirements, designs,
+ * reviews, etc.) backed by an adapter. The filesystem adapter is the
+ * Phase 1 implementation; future adapters (Linear, Jira, GitHub) implement
+ * the same contract. See ADR-0011.
+ */
+export {};

package/dist/types/evaluation-rubric.d.ts

@@ -0,0 +1,18 @@
+export interface EvaluationRubric {
+    rubric: {
+        artifact_type: string;
+        scoring_scale?: number;
+        pass_threshold: number;
+        aggregate_threshold?: number;
+        divergence_threshold?: number;
+        models?: string[];
+        criteria: Criterion[];
+    };
+}
+export interface Criterion {
+    name: string;
+    weight: CriterionWeight;
+    description?: string;
+}
+export type CriterionWeight = 'blocking' | 'important' | 'advisory';
+//# sourceMappingURL=evaluation-rubric.d.ts.map

package/dist/types/evaluation-rubric.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"evaluation-rubric.d.ts","sourceRoot":"","sources":["../../src/types/evaluation-rubric.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,gBAAgB;IAC/B,MAAM,EAAE;QACN,aAAa,EAAE,MAAM,CAAC;QACtB,aAAa,CAAC,EAAE,MAAM,CAAC;QACvB,cAAc,EAAE,MAAM,CAAC;QACvB,mBAAmB,CAAC,EAAE,MAAM,CAAC;QAC7B,oBAAoB,CAAC,EAAE,MAAM,CAAC;QAC9B,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;QAClB,QAAQ,EAAE,SAAS,EAAE,CAAC;KACvB,CAAC;CACH;AAED,MAAM,WAAW,SAAS;IACxB,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,eAAe,CAAC;IACxB,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,MAAM,eAAe,GAAG,UAAU,GAAG,WAAW,GAAG,UAAU,CAAC"}

package/dist/types/evaluation-rubric.js

@@ -0,0 +1 @@
+export {};

package/dist/types/index.d.ts

@@ -0,0 +1,10 @@
+export type { PersonaSpec, Identity, Perception, ContextRef, Task, SimpleTask, CompositeTask, SubAgent, ToolPermissions, Cadence, ScheduleEntry, EventEntry, EvaluationConfig, TriggerType, QualityGateType, } from './persona-spec.js';
+export type { ProjectConfig, SourceConfig, WorkspaceConfig, LlmConfig, Provider, } from './project-config.js';
+export type { EvaluationRubric, Criterion, CriterionWeight } from './evaluation-rubric.js';
+export type { RunStatus, RunRecord } from './run-state.js';
+export type { Provenance, ProvenanceVersions, ProvenanceInputs, ProvenanceOutputs, ProvenanceEvaluation, ProvenanceCost, ArtifactReference, } from './provenance.js';
+export type { LlmProvider, GenerateTextOptions, GenerateTextResult, LlmMessage, ToolCallRecord, ToolDefinition, ToolSet, } from './llm-provider.js';
+export type { ArtifactStore, ArtifactRecord, ArtifactVersion, ArtifactListFilter, ArtifactWriteResult, } from './artifact-store.js';
+export type { CrewTool, CrewToolSet, ToolExecutionContext, ToolExecutionRecord, ToolLogger, } from './tool-runtime.js';
+export { createNullToolContext } from './tool-runtime.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/types/index.ts"],"names":[],"mappings":"AAAA,YAAY,EACV,WAAW,EACX,QAAQ,EACR,UAAU,EACV,UAAU,EACV,IAAI,EACJ,UAAU,EACV,aAAa,EACb,QAAQ,EACR,eAAe,EACf,OAAO,EACP,aAAa,EACb,UAAU,EACV,gBAAgB,EAChB,WAAW,EACX,eAAe,GAChB,MAAM,mBAAmB,CAAC;AAE3B,YAAY,EACV,aAAa,EACb,YAAY,EACZ,eAAe,EACf,SAAS,EACT,QAAQ,GACT,MAAM,qBAAqB,CAAC;AAE7B,YAAY,EAAE,gBAAgB,EAAE,SAAS,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AAE3F,YAAY,EAAE,SAAS,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAE3D,YAAY,EACV,UAAU,EACV,kBAAkB,EAClB,gBAAgB,EAChB,iBAAiB,EACjB,oBAAoB,EACpB,cAAc,EACd,iBAAiB,GAClB,MAAM,iBAAiB,CAAC;AAEzB,YAAY,EACV,WAAW,EACX,mBAAmB,EACnB,kBAAkB,EAClB,UAAU,EACV,cAAc,EACd,cAAc,EACd,OAAO,GACR,MAAM,mBAAmB,CAAC;AAE3B,YAAY,EACV,aAAa,EACb,cAAc,EACd,eAAe,EACf,kBAAkB,EAClB,mBAAmB,GACpB,MAAM,qBAAqB,CAAC;AAE7B,YAAY,EACV,QAAQ,EACR,WAAW,EACX,oBAAoB,EACpB,mBAAmB,EACnB,UAAU,GACX,MAAM,mBAAmB,CAAC;AAE3B,OAAO,EAAE,qBAAqB,EAAE,MAAM,mBAAmB,CAAC"}

package/dist/types/index.js

@@ -0,0 +1 @@
+export { createNullToolContext } from './tool-runtime.js';

package/dist/types/llm-provider.d.ts

@@ -0,0 +1,47 @@
+/**
+ * Crew-defined LLM provider interface.
+ *
+ * Provider packages (e.g., @helmiq/anthropic-sdk) implement this interface.
+ * The runtime depends only on these types, never on SDK-specific types.
+ * See ADR-0009.
+ */
+export interface LlmProvider {
+    generateText(options: GenerateTextOptions): Promise<GenerateTextResult>;
+}
+export interface GenerateTextOptions {
+    model: string;
+    system: string;
+    messages: LlmMessage[];
+    tools?: ToolSet;
+    maxRetries?: number;
+}
+export interface GenerateTextResult {
+    text: string;
+    toolCalls: ToolCallRecord[];
+    tokensIn: number;
+    tokensOut: number;
+}
+export type LlmMessage = {
+    role: 'user' | 'assistant' | 'system';
+    content: string;
+} | {
+    role: 'tool';
+    toolCallId: string;
+    toolName: string;
+    content: string;
+};
+export interface ToolCallRecord {
+    toolCallId: string;
+    toolName: string;
+    input: unknown;
+}
+/**
+ * A tool definition that the LLM can invoke.
+ * Vendor packages convert this to the SDK-specific tool format internally.
+ */
+export interface ToolDefinition {
+    description: string;
+    parameters: Record<string, unknown>;
+}
+export type ToolSet = Record<string, ToolDefinition>;
+//# sourceMappingURL=llm-provider.d.ts.map

package/dist/types/llm-provider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"llm-provider.d.ts","sourceRoot":"","sources":["../../src/types/llm-provider.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,MAAM,WAAW,WAAW;IAC1B,YAAY,CAAC,OAAO,EAAE,mBAAmB,GAAG,OAAO,CAAC,kBAAkB,CAAC,CAAC;CACzE;AAED,MAAM,WAAW,mBAAmB;IAClC,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,UAAU,EAAE,CAAC;IACvB,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,kBAAkB;IACjC,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,cAAc,EAAE,CAAC;IAC5B,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,MAAM,UAAU,GAClB;IAAE,IAAI,EAAE,MAAM,GAAG,WAAW,GAAG,QAAQ,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,GAC1D;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,UAAU,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,CAAC;AAE5E,MAAM,WAAW,cAAc;IAC7B,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,OAAO,CAAC;CAChB;AAED;;;GAGG;AACH,MAAM,WAAW,cAAc;IAC7B,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACrC;AAED,MAAM,MAAM,OAAO,GAAG,MAAM,CAAC,MAAM,EAAE,cAAc,CAAC,CAAC"}

package/dist/types/llm-provider.js

@@ -0,0 +1,8 @@
+/**
+ * Crew-defined LLM provider interface.
+ *
+ * Provider packages (e.g., @helmiq/anthropic-sdk) implement this interface.
+ * The runtime depends only on these types, never on SDK-specific types.
+ * See ADR-0009.
+ */
+export {};

package/dist/types/persona-spec.d.ts

@@ -0,0 +1,79 @@
+export interface PersonaSpec {
+    persona: {
+        name: string;
+        identity: Identity;
+        skills: string[];
+        perception: Perception;
+        tasks: Record<string, Task>;
+        tools: ToolPermissions;
+        cadence: Cadence;
+        evaluation: EvaluationConfig;
+    };
+}
+export interface Identity {
+    role: string;
+}
+export interface Perception {
+    always_read?: ContextRef[];
+    per_task: Record<string, ContextRef[]>;
+}
+export interface ContextRef {
+    artifact: string;
+    scope?: Record<string, string>;
+    sections?: string[];
+    when?: string;
+}
+export type Task = SimpleTask | CompositeTask;
+export interface SimpleTask {
+    mode: 'simple';
+    trigger: TriggerType[];
+    skill: string;
+    reads?: string[];
+    produces: string;
+    tools?: string[];
+    published_artifact?: string;
+    quality_gate?: QualityGateType;
+}
+export interface CompositeTask {
+    mode: 'composite';
+    trigger: TriggerType[];
+    sub_agents: SubAgent[];
+    published_artifact: string;
+    quality_gate?: QualityGateType;
+}
+export interface SubAgent {
+    name: string;
+    skill: string;
+    reads: string[];
+    produces: string;
+    tools?: string[];
+    max_iterations?: number;
+    gate?: string;
+    on_fail?: string;
+    max_loops?: number;
+}
+export interface ToolPermissions {
+    permitted: string[];
+    denied: string[];
+    writable_paths?: string[];
+}
+export interface Cadence {
+    scheduled?: ScheduleEntry[];
+    event?: EventEntry[];
+}
+export interface ScheduleEntry {
+    cron: string;
+    task: string;
+}
+export interface EventEntry {
+    on: string;
+    task: string;
+}
+export interface EvaluationConfig {
+    self_eval_model?: string;
+    rubric: string;
+    multi_model?: boolean;
+}
+export type TriggerType = 'manual' | 'scheduled' | 'event';
+export type QualityGateType = 'self-eval' | 'human-review' | 'multi-model';
+//# sourceMappingURL=persona-spec.d.ts.map

package/dist/types/persona-spec.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"persona-spec.d.ts","sourceRoot":"","sources":["../../src/types/persona-spec.ts"],"names":[],"mappings":"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"}

package/dist/types/persona-spec.js

@@ -0,0 +1 @@
+export {};

package/dist/types/project-config.d.ts

@@ -0,0 +1,28 @@
+export interface ProjectConfig {
+    project: {
+        name: string;
+        key: string;
+    };
+    workspace: WorkspaceConfig;
+    source: SourceConfig;
+    llm: LlmConfig;
+}
+export interface SourceConfig {
+    repo: string;
+    path: string;
+}
+export interface WorkspaceConfig {
+    path: string;
+    work: string;
+    runs: string;
+}
+export interface LlmConfig {
+    default_model: string;
+    allowed_models?: string[];
+    providers: Record<string, Provider>;
+}
+export interface Provider {
+    api_key_env: string;
+    models: Record<string, string>;
+}
+//# sourceMappingURL=project-config.d.ts.map

package/dist/types/project-config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"project-config.d.ts","sourceRoot":"","sources":["../../src/types/project-config.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,aAAa;IAC5B,OAAO,EAAE;QACP,IAAI,EAAE,MAAM,CAAC;QACb,GAAG,EAAE,MAAM,CAAC;KACb,CAAC;IACF,SAAS,EAAE,eAAe,CAAC;IAC3B,MAAM,EAAE,YAAY,CAAC;IACrB,GAAG,EAAE,SAAS,CAAC;CAChB;AAED,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,SAAS;IACxB,aAAa,EAAE,MAAM,CAAC;IACtB,cAAc,CAAC,EAAE,MAAM,EAAE,CAAC;IAC1B,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC;CACrC;AAED,MAAM,WAAW,QAAQ;IACvB,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAChC"}

package/dist/types/project-config.js

@@ -0,0 +1 @@
+export {};

package/dist/types/provenance.d.ts

@@ -0,0 +1,67 @@
+import type { TriggerType } from './persona-spec.js';
+import type { RunStatus } from './run-state.js';
+export interface Provenance {
+    run_id: string;
+    parent_run_id?: string;
+    persona: string;
+    task: string;
+    sub_agent_chain?: string[];
+    feedback_iteration?: number;
+    versions: ProvenanceVersions;
+    timestamp: string;
+    duration_ms: number;
+    trigger: TriggerType;
+    inputs: ProvenanceInputs;
+    outputs: ProvenanceOutputs;
+    evaluation: ProvenanceEvaluation;
+    cost: ProvenanceCost;
+    run_state: RunStatus;
+}
+export interface ProvenanceVersions {
+    persona_spec_hash: string;
+    prompt_hashes: Record<string, string>;
+    model: string;
+    rubric_hash: string;
+    runtime_version: string;
+}
+export interface ProvenanceInputs {
+    artifacts_read: ArtifactReference[];
+    context_tokens: number;
+}
+export interface ArtifactReference {
+    type: string;
+    path: string;
+    commit?: string;
+    status?: string;
+    sections?: string[];
+    repo?: string;
+    files?: number;
+}
+export interface ProvenanceOutputs {
+    artifact_produced: {
+        type: string;
+        id: string;
+    };
+    target_repo_branch?: string;
+    target_repo_commit?: string;
+    files_changed?: number;
+    tests_added?: number;
+    work_products?: string[];
+}
+export interface ProvenanceEvaluation {
+    self_eval_score?: number;
+    self_eval_pass?: boolean;
+    self_eval_model?: string;
+    automated_checks?: Record<string, string>;
+    multi_model_eval?: unknown;
+    human_review?: string;
+    human_reviewer?: string;
+    human_decision?: string;
+    human_decision_timestamp?: string;
+}
+export interface ProvenanceCost {
+    llm_calls: number;
+    total_tokens: number;
+    estimated_cost_usd: number;
+}
+//# sourceMappingURL=provenance.d.ts.map

package/dist/types/provenance.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"provenance.d.ts","sourceRoot":"","sources":["../../src/types/provenance.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AACrD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAEhD,MAAM,WAAW,UAAU;IACzB,MAAM,EAAE,MAAM,CAAC;IACf,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,CAAC;IACb,eAAe,CAAC,EAAE,MAAM,EAAE,CAAC;IAC3B,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,QAAQ,EAAE,kBAAkB,CAAC;IAC7B,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,EAAE,WAAW,CAAC;IACrB,MAAM,EAAE,gBAAgB,CAAC;IACzB,OAAO,EAAE,iBAAiB,CAAC;IAC3B,UAAU,EAAE,oBAAoB,CAAC;IACjC,IAAI,EAAE,cAAc,CAAC;IACrB,SAAS,EAAE,SAAS,CAAC;CACtB;AAED,MAAM,WAAW,kBAAkB;IACjC,iBAAiB,EAAE,MAAM,CAAC;IAC1B,aAAa,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACtC,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,MAAM,CAAC;IACpB,eAAe,EAAE,MAAM,CAAC;CACzB;AAED,MAAM,WAAW,gBAAgB;IAC/B,cAAc,EAAE,iBAAiB,EAAE,CAAC;IACpC,cAAc,EAAE,MAAM,CAAC;CACxB;AAED,MAAM,WAAW,iBAAiB;IAChC,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;IACpB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,iBAAiB;IAChC,iBAAiB,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,EAAE,EAAE,MAAM,CAAA;KAAE,CAAC;IAChD,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,aAAa,CAAC,EAAE,MAAM,EAAE,CAAC;CAC1B;AAED,MAAM,WAAW,oBAAoB;IACnC,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,gBAAgB,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC1C,gBAAgB,CAAC,EAAE,OAAO,CAAC;IAC3B,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,wBAAwB,CAAC,EAAE,MAAM,CAAC;CACnC;AAED,MAAM,WAAW,cAAc;IAC7B,SAAS,EAAE,MAAM,CAAC;IAClB,YAAY,EAAE,MAAM,CAAC;IACrB,kBAAkB,EAAE,MAAM,CAAC;CAC5B"}

package/dist/types/provenance.js

@@ -0,0 +1 @@
+export {};

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

@@ -0,0 +1,11 @@
+export type RunStatus = 'queued' | 'running' | 'evaluating' | 'publishing' | 'published' | 'failed' | 'awaiting_review' | 'approved' | 'rejected';
+export interface RunRecord {
+    run_id: string;
+    persona: string;
+    task: string;
+    scope: string;
+    status: RunStatus;
+    started_at: string;
+    completed_at?: string;
+}
+//# sourceMappingURL=run-state.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"run-state.d.ts","sourceRoot":"","sources":["../../src/types/run-state.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,SAAS,GACjB,QAAQ,GACR,SAAS,GACT,YAAY,GACZ,YAAY,GACZ,WAAW,GACX,QAAQ,GACR,iBAAiB,GACjB,UAAU,GACV,UAAU,CAAC;AAEf,MAAM,WAAW,SAAS;IACxB,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,SAAS,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;IACnB,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB"}

package/dist/types/run-state.js

@@ -0,0 +1 @@
+export {};

package/dist/types/tool-runtime.d.ts

@@ -0,0 +1,43 @@
+/**
+ * Runtime-facing tool contracts per ADR-0010.
+ *
+ * CrewTool combines a JSON schema (for the LLM) with an execute function
+ * (for the runtime). The runtime strips execute to produce schema-only
+ * ToolSet for the provider, then dispatches tool calls back to execute.
+ */
+import type { ProjectConfig } from './project-config.js';
+export type ToolLogger = (message: string, data?: Record<string, unknown>) => void;
+export interface ToolExecutionContext {
+    workspacePath: string;
+    targetRepoPath: string;
+    project: ProjectConfig;
+    persona: string;
+    task: string;
+    runId: string;
+    protectedPaths: string[];
+    logger: ToolLogger;
+}
+export interface CrewTool<TParams = unknown, TResult = unknown> {
+    name: string;
+    description: string;
+    parameters: Record<string, unknown>;
+    execute: (params: TParams, context: ToolExecutionContext) => Promise<TResult>;
+}
+export type CrewToolSet = Record<string, CrewTool>;
+/**
+ * Build a stub ToolExecutionContext for cases where no real context is
+ * available (e.g. tests with mocked tools). Paths are empty so any
+ * real tool call would fail -- callers should prefer providing a real
+ * context via the toolContext parameter.
+ */
+export declare function createNullToolContext(persona: string, task: string): ToolExecutionContext;
+export interface ToolExecutionRecord {
+    toolCallId: string;
+    toolName: string;
+    inputSummary: string;
+    outputSummary: string;
+    durationMs: number;
+    success: boolean;
+    errorCode?: string;
+}
+//# sourceMappingURL=tool-runtime.d.ts.map

package/dist/types/tool-runtime.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool-runtime.d.ts","sourceRoot":"","sources":["../../src/types/tool-runtime.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAEzD,MAAM,MAAM,UAAU,GAAG,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,IAAI,CAAC;AAEnF,MAAM,WAAW,oBAAoB;IACnC,aAAa,EAAE,MAAM,CAAC;IACtB,cAAc,EAAE,MAAM,CAAC;IACvB,OAAO,EAAE,aAAa,CAAC;IACvB,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,cAAc,EAAE,MAAM,EAAE,CAAC;IACzB,MAAM,EAAE,UAAU,CAAC;CACpB;AAED,MAAM,WAAW,QAAQ,CAAC,OAAO,GAAG,OAAO,EAAE,OAAO,GAAG,OAAO;IAC5D,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACpC,OAAO,EAAE,CAAC,MAAM,EAAE,OAAO,EAAE,OAAO,EAAE,oBAAoB,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC;CAC/E;AAED,MAAM,MAAM,WAAW,GAAG,MAAM,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC;AAEnD;;;;;GAKG;AACH,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,oBAAoB,CAgBzF;AAED,MAAM,WAAW,mBAAmB;IAClC,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC;IACjB,YAAY,EAAE,MAAM,CAAC;IACrB,aAAa,EAAE,MAAM,CAAC;IACtB,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,EAAE,OAAO,CAAC;IACjB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB"}

package/dist/types/tool-runtime.js

@@ -0,0 +1,30 @@
+/**
+ * Runtime-facing tool contracts per ADR-0010.
+ *
+ * CrewTool combines a JSON schema (for the LLM) with an execute function
+ * (for the runtime). The runtime strips execute to produce schema-only
+ * ToolSet for the provider, then dispatches tool calls back to execute.
+ */
+/**
+ * Build a stub ToolExecutionContext for cases where no real context is
+ * available (e.g. tests with mocked tools). Paths are empty so any
+ * real tool call would fail -- callers should prefer providing a real
+ * context via the toolContext parameter.
+ */
+export function createNullToolContext(persona, task) {
+    return {
+        workspacePath: '',
+        targetRepoPath: '',
+        project: {
+            project: { name: '', key: '' },
+            workspace: { path: '', work: '', runs: '' },
+            source: { repo: '', path: '' },
+            llm: { default_model: '', providers: {} },
+        },
+        persona,
+        task,
+        runId: '',
+        protectedPaths: [],
+        logger: () => { },
+    };
+}

package/dist/workspace/detect.d.ts

@@ -0,0 +1,11 @@
+export declare class WorkspaceNotFoundError extends Error {
+    readonly code: "WORKSPACE_NOT_FOUND";
+    constructor(startDir: string);
+}
+/**
+ * Walk up from `startDir` looking for a directory containing `.crew/config`.
+ * Returns the absolute path of the first matching directory.
+ * Throws `WorkspaceNotFoundError` if the filesystem root is reached without a match.
+ */
+export declare function detectWorkspace(startDir: string): string;
+//# sourceMappingURL=detect.d.ts.map

package/dist/workspace/detect.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"detect.d.ts","sourceRoot":"","sources":["../../src/workspace/detect.ts"],"names":[],"mappings":"AAGA,qBAAa,sBAAuB,SAAQ,KAAK;IAC/C,QAAQ,CAAC,IAAI,EAAG,qBAAqB,CAAU;gBAEnC,QAAQ,EAAE,MAAM;CAO7B;AAED;;;;GAIG;AACH,wBAAgB,eAAe,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAaxD"}

package/dist/workspace/detect.js

@@ -0,0 +1,28 @@
+import { existsSync } from 'node:fs';
+import { dirname, join, resolve } from 'node:path';
+export class WorkspaceNotFoundError extends Error {
+    code = 'WORKSPACE_NOT_FOUND';
+    constructor(startDir) {
+        super(`No workspace found. Searched from '${startDir}' to filesystem root for .crew/config. ` +
+            `Run from within a workspace directory or pass --workspace.`);
+        this.name = 'WorkspaceNotFoundError';
+    }
+}
+/**
+ * Walk up from `startDir` looking for a directory containing `.crew/config`.
+ * Returns the absolute path of the first matching directory.
+ * Throws `WorkspaceNotFoundError` if the filesystem root is reached without a match.
+ */
+export function detectWorkspace(startDir) {
+    let dir = resolve(startDir);
+    while (true) {
+        if (existsSync(join(dir, '.crew', 'config'))) {
+            return dir;
+        }
+        const parent = dirname(dir);
+        if (parent === dir) {
+            throw new WorkspaceNotFoundError(startDir);
+        }
+        dir = parent;
+    }
+}

package/dist/workspace/detect.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=detect.test.d.ts.map

package/dist/workspace/detect.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"detect.test.d.ts","sourceRoot":"","sources":["../../src/workspace/detect.test.ts"],"names":[],"mappings":""}

package/dist/workspace/detect.test.js

@@ -0,0 +1,53 @@
+import { describe, it, expect, beforeEach, afterEach } from 'vitest';
+import { mkdtempSync, mkdirSync, writeFileSync, rmSync } from 'node:fs';
+import { join } from 'node:path';
+import { tmpdir } from 'node:os';
+import { detectWorkspace, WorkspaceNotFoundError } from './detect.js';
+describe('detectWorkspace', () => {
+    let tempDir;
+    beforeEach(() => {
+        tempDir = mkdtempSync(join(tmpdir(), 'crew-ws-detect-'));
+    });
+    afterEach(() => {
+        rmSync(tempDir, { recursive: true, force: true });
+    });
+    it('finds workspace when .crew/config exists in the start directory', () => {
+        mkdirSync(join(tempDir, '.crew'), { recursive: true });
+        writeFileSync(join(tempDir, '.crew', 'config'), 'project: {}');
+        expect(detectWorkspace(tempDir)).toBe(tempDir);
+    });
+    it('finds workspace in a parent directory', () => {
+        mkdirSync(join(tempDir, '.crew'), { recursive: true });
+        writeFileSync(join(tempDir, '.crew', 'config'), 'project: {}');
+        const nested = join(tempDir, 'a', 'b', 'c');
+        mkdirSync(nested, { recursive: true });
+        expect(detectWorkspace(nested)).toBe(tempDir);
+    });
+    it('throws WorkspaceNotFoundError when no workspace exists', () => {
+        const noWorkspace = join(tempDir, 'empty');
+        mkdirSync(noWorkspace, { recursive: true });
+        expect(() => detectWorkspace(noWorkspace)).toThrow(WorkspaceNotFoundError);
+    });
+    it('error message mentions --workspace flag', () => {
+        const noWorkspace = join(tempDir, 'empty');
+        mkdirSync(noWorkspace, { recursive: true });
+        try {
+            detectWorkspace(noWorkspace);
+            expect.fail('should have thrown');
+        }
+        catch (err) {
+            expect(err).toBeInstanceOf(WorkspaceNotFoundError);
+            expect(err.message).toContain('--workspace');
+        }
+    });
+    it('finds the nearest workspace when multiple exist in the ancestor chain', () => {
+        mkdirSync(join(tempDir, '.crew'), { recursive: true });
+        writeFileSync(join(tempDir, '.crew', 'config'), 'project: {}');
+        const inner = join(tempDir, 'sub');
+        mkdirSync(join(inner, '.crew'), { recursive: true });
+        writeFileSync(join(inner, '.crew', 'config'), 'project: {}');
+        const deepChild = join(inner, 'deep');
+        mkdirSync(deepChild, { recursive: true });
+        expect(detectWorkspace(deepChild)).toBe(inner);
+    });
+});

package/dist/workspace/index.d.ts

@@ -0,0 +1,2 @@
+export { detectWorkspace, WorkspaceNotFoundError } from './detect.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/workspace/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,sBAAsB,EAAE,MAAM,aAAa,CAAC"}

package/dist/workspace/index.js

@@ -0,0 +1 @@
+export { detectWorkspace, WorkspaceNotFoundError } from './detect.js';

package/package.json

@@ -0,0 +1,51 @@
+{
+  "name": "@helmiq/crew",
+  "version": "0.1.0",
+  "description": "Artifact-centric autonomous delivery runtime",
+  "type": "module",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/helmiq/crew",
+    "directory": "packages/crew"
+  },
+  "keywords": [
+    "helmiq",
+    "crew",
+    "delivery",
+    "ai-agents",
+    "runtime"
+  ],
+  "engines": {
+    "node": ">=20.9.0"
+  },
+  "files": [
+    "dist",
+    "defaults"
+  ],
+  "exports": {
+    ".": {
+      "import": "./dist/index.js",
+      "types": "./dist/index.d.ts"
+    }
+  },
+  "dependencies": {
+    "gray-matter": "^4.0.3",
+    "js-tiktoken": "^1.0.21",
+    "simple-git": "^3.33.0",
+    "yaml": "^2.8.3",
+    "zod": "^4.3.6",
+    "@helmiq/crew-code": "0.1.0",
+    "@helmiq/crew-git": "0.1.0",
+    "@helmiq/crew-shell": "0.1.0"
+  },
+  "devDependencies": {
+    "@types/node": "^25.5.0",
+    "typescript": "^6.0.2",
+    "@helmiq/typescript-config": "0.0.0"
+  },
+  "scripts": {
+    "build": "tsc --project tsconfig.json",
+    "typecheck": "tsc --noEmit --project tsconfig.json"
+  }
+}