human-in-the-loop 0.1.0 → 2.0.2

package/dist/helpers.d.ts

@@ -0,0 +1,308 @@
+/**
+ * Helper functions for common human-in-the-loop patterns
+ */
+import type { Role, Team, Goals, KPIs, OKRs, Human as HumanType, ApprovalResponse } from './types.js';
+import { Human } from './human.js';
+/**
+ * Define a human role
+ *
+ * @example
+ * ```ts
+ * const techLead = Role({
+ *   id: 'tech-lead',
+ *   name: 'Tech Lead',
+ *   capabilities: ['approve-prs', 'deploy-prod'],
+ *   escalatesTo: 'engineering-manager',
+ * })
+ * ```
+ */
+export declare function Role(role: Role): Role;
+/**
+ * Define a team
+ *
+ * @example
+ * ```ts
+ * const engineering = Team({
+ *   id: 'engineering',
+ *   name: 'Engineering Team',
+ *   members: ['alice', 'bob', 'charlie'],
+ *   lead: 'alice',
+ * })
+ * ```
+ */
+export declare function Team(team: Team): Team;
+/**
+ * Define goals for a team or individual
+ *
+ * @example
+ * ```ts
+ * const q1Goals = Goals({
+ *   id: 'q1-2024',
+ *   objectives: [
+ *     'Launch v2.0',
+ *     'Improve performance by 50%',
+ *   ],
+ *   targetDate: new Date('2024-03-31'),
+ * })
+ * ```
+ */
+export declare function Goals(goals: Goals): Goals;
+/**
+ * Request approval from a human
+ *
+ * @example
+ * ```ts
+ * const result = await approve({
+ *   title: 'Deploy to production',
+ *   description: 'Deploy v2.0.0 to production',
+ *   subject: 'Production Deployment',
+ *   input: { version: '2.0.0', environment: 'prod' },
+ *   assignee: 'tech-lead@example.com',
+ *   priority: 'high',
+ * })
+ *
+ * if (result.approved) {
+ *   await deploy()
+ * }
+ * ```
+ */
+export declare function approve<TData = unknown>(params: {
+    title: string;
+    description: string;
+    subject: string;
+    input: TData;
+    assignee?: string | string[];
+    role?: string;
+    team?: string;
+    priority?: 'low' | 'normal' | 'high' | 'critical';
+    timeout?: number;
+    escalatesTo?: string | string[];
+    requiresApproval?: boolean;
+    approvers?: string[];
+    metadata?: Record<string, unknown>;
+}): Promise<ApprovalResponse>;
+/**
+ * Ask a question to a human
+ *
+ * @example
+ * ```ts
+ * const answer = await ask({
+ *   title: 'Product naming',
+ *   question: 'What should we name the new feature?',
+ *   context: { feature: 'AI Assistant' },
+ *   assignee: 'product-manager@example.com',
+ * })
+ * ```
+ */
+export declare function ask(params: {
+    title: string;
+    question: string;
+    context?: unknown;
+    assignee?: string | string[];
+    role?: string;
+    team?: string;
+    priority?: 'low' | 'normal' | 'high' | 'critical';
+    timeout?: number;
+    suggestions?: string[];
+    metadata?: Record<string, unknown>;
+}): Promise<string>;
+/**
+ * Request a human to perform a task
+ *
+ * This uses the digital-workers interface for humans
+ *
+ * @example
+ * ```ts
+ * const result = await do({
+ *   title: 'Review code',
+ *   instructions: 'Review the PR and provide feedback',
+ *   input: { prUrl: 'https://github.com/...' },
+ *   assignee: 'senior-dev@example.com',
+ * })
+ * ```
+ */
+export declare function do_<TInput = unknown, TOutput = unknown>(params: {
+    title: string;
+    instructions: string;
+    input: TInput;
+    assignee?: string | string[];
+    role?: string;
+    team?: string;
+    priority?: 'low' | 'normal' | 'high' | 'critical';
+    timeout?: number;
+    tools?: any[];
+    estimatedEffort?: string;
+    metadata?: Record<string, unknown>;
+}): Promise<TOutput>;
+export { do_ as do };
+/**
+ * Request a human to make a decision
+ *
+ * @example
+ * ```ts
+ * const choice = await decide({
+ *   title: 'Pick deployment strategy',
+ *   options: ['blue-green', 'canary', 'rolling'],
+ *   context: { risk: 'high', users: 100000 },
+ *   assignee: 'devops-lead@example.com',
+ * })
+ * ```
+ */
+export declare function decide<TOptions extends string = string>(params: {
+    title: string;
+    description?: string;
+    options: TOptions[];
+    context?: unknown;
+    assignee?: string | string[];
+    role?: string;
+    team?: string;
+    priority?: 'low' | 'normal' | 'high' | 'critical';
+    timeout?: number;
+    criteria?: string[];
+    metadata?: Record<string, unknown>;
+}): Promise<TOptions>;
+/**
+ * Request generation/content creation from a human
+ *
+ * This is a specialized form of do() for content generation
+ *
+ * @example
+ * ```ts
+ * const content = await generate({
+ *   title: 'Write blog post',
+ *   instructions: 'Write a blog post about our new feature',
+ *   input: { topic: 'AI Assistant', targetAudience: 'developers' },
+ *   assignee: 'content-writer@example.com',
+ * })
+ * ```
+ */
+export declare function generate<TInput = unknown>(params: {
+    title: string;
+    instructions: string;
+    input: TInput;
+    assignee?: string | string[];
+    role?: string;
+    team?: string;
+    priority?: 'low' | 'normal' | 'high' | 'critical';
+    timeout?: number;
+    metadata?: Record<string, unknown>;
+}): Promise<string>;
+/**
+ * Type checking/validation request
+ *
+ * Ask a human to validate data or check type compliance
+ *
+ * @example
+ * ```ts
+ * const valid = await is({
+ *   title: 'Validate user data',
+ *   question: 'Is this user data valid and complete?',
+ *   input: userData,
+ *   assignee: 'data-specialist@example.com',
+ * })
+ * ```
+ */
+export declare function is(params: {
+    title: string;
+    question: string;
+    input: unknown;
+    assignee?: string | string[];
+    role?: string;
+    team?: string;
+    priority?: 'low' | 'normal' | 'high' | 'critical';
+    timeout?: number;
+    metadata?: Record<string, unknown>;
+}): Promise<boolean>;
+/**
+ * Send a notification to a human
+ *
+ * @example
+ * ```ts
+ * await notify({
+ *   type: 'info',
+ *   title: 'Deployment complete',
+ *   message: 'Version 2.0.0 deployed successfully',
+ *   recipient: 'team@example.com',
+ *   channels: ['slack', 'email'],
+ * })
+ * ```
+ */
+export declare function notify(params: {
+    type: 'info' | 'warning' | 'error' | 'success';
+    title: string;
+    message: string;
+    recipient: string | string[];
+    channels?: ('slack' | 'email' | 'sms' | 'web')[];
+    priority?: 'low' | 'normal' | 'high' | 'critical';
+    data?: unknown;
+}): Promise<void>;
+/**
+ * Track Key Performance Indicators
+ *
+ * @example
+ * ```ts
+ * kpis({
+ *   id: 'monthly-revenue',
+ *   name: 'Monthly Revenue',
+ *   value: 150000,
+ *   target: 200000,
+ *   unit: 'USD',
+ *   trend: 'up',
+ * })
+ * ```
+ */
+export declare function kpis(kpis: KPIs): KPIs;
+/**
+ * Define Objectives and Key Results
+ *
+ * @example
+ * ```ts
+ * okrs({
+ *   id: 'q1-2024-growth',
+ *   objective: 'Accelerate user growth',
+ *   keyResults: [
+ *     {
+ *       description: 'Increase active users by 50%',
+ *       progress: 0.3,
+ *       current: 13000,
+ *       target: 15000,
+ *     },
+ *     {
+ *       description: 'Achieve 95% customer satisfaction',
+ *       progress: 0.85,
+ *       current: 0.93,
+ *       target: 0.95,
+ *     },
+ *   ],
+ *   period: 'Q1 2024',
+ *   owner: 'ceo@example.com',
+ * })
+ * ```
+ */
+export declare function okrs(okrs: OKRs): OKRs;
+/**
+ * Register a human worker in the system
+ *
+ * @example
+ * ```ts
+ * const alice = registerHuman({
+ *   id: 'alice',
+ *   name: 'Alice Smith',
+ *   email: 'alice@example.com',
+ *   roles: ['tech-lead', 'developer'],
+ *   teams: ['engineering', 'frontend'],
+ *   channels: {
+ *     slack: '@alice',
+ *     email: 'alice@example.com',
+ *   },
+ * })
+ * ```
+ */
+export declare function registerHuman(human: HumanType): HumanType;
+/**
+ * Get the default Human manager instance
+ *
+ * Use this to access the underlying HumanManager for advanced operations
+ */
+export declare function getDefaultHuman(): ReturnType<typeof Human>;
+//# sourceMappingURL=helpers.d.ts.map

package/dist/helpers.d.ts.map

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

package/dist/helpers.js

@@ -0,0 +1,275 @@
+/**
+ * Helper functions for common human-in-the-loop patterns
+ */
+import { Human } from './human.js';
+/**
+ * Create a default Human instance for convenience
+ */
+const defaultHuman = Human();
+/**
+ * Define a human role
+ *
+ * @example
+ * ```ts
+ * const techLead = Role({
+ *   id: 'tech-lead',
+ *   name: 'Tech Lead',
+ *   capabilities: ['approve-prs', 'deploy-prod'],
+ *   escalatesTo: 'engineering-manager',
+ * })
+ * ```
+ */
+export function Role(role) {
+    return defaultHuman.defineRole(role);
+}
+/**
+ * Define a team
+ *
+ * @example
+ * ```ts
+ * const engineering = Team({
+ *   id: 'engineering',
+ *   name: 'Engineering Team',
+ *   members: ['alice', 'bob', 'charlie'],
+ *   lead: 'alice',
+ * })
+ * ```
+ */
+export function Team(team) {
+    return defaultHuman.defineTeam(team);
+}
+/**
+ * Define goals for a team or individual
+ *
+ * @example
+ * ```ts
+ * const q1Goals = Goals({
+ *   id: 'q1-2024',
+ *   objectives: [
+ *     'Launch v2.0',
+ *     'Improve performance by 50%',
+ *   ],
+ *   targetDate: new Date('2024-03-31'),
+ * })
+ * ```
+ */
+export function Goals(goals) {
+    return defaultHuman.defineGoals(goals);
+}
+/**
+ * Request approval from a human
+ *
+ * @example
+ * ```ts
+ * const result = await approve({
+ *   title: 'Deploy to production',
+ *   description: 'Deploy v2.0.0 to production',
+ *   subject: 'Production Deployment',
+ *   input: { version: '2.0.0', environment: 'prod' },
+ *   assignee: 'tech-lead@example.com',
+ *   priority: 'high',
+ * })
+ *
+ * if (result.approved) {
+ *   await deploy()
+ * }
+ * ```
+ */
+export async function approve(params) {
+    return defaultHuman.approve(params);
+}
+/**
+ * Ask a question to a human
+ *
+ * @example
+ * ```ts
+ * const answer = await ask({
+ *   title: 'Product naming',
+ *   question: 'What should we name the new feature?',
+ *   context: { feature: 'AI Assistant' },
+ *   assignee: 'product-manager@example.com',
+ * })
+ * ```
+ */
+export async function ask(params) {
+    return defaultHuman.ask(params);
+}
+/**
+ * Request a human to perform a task
+ *
+ * This uses the digital-workers interface for humans
+ *
+ * @example
+ * ```ts
+ * const result = await do({
+ *   title: 'Review code',
+ *   instructions: 'Review the PR and provide feedback',
+ *   input: { prUrl: 'https://github.com/...' },
+ *   assignee: 'senior-dev@example.com',
+ * })
+ * ```
+ */
+export async function do_(params) {
+    return defaultHuman.do(params);
+}
+// Export as 'do' for the API, but define as 'do_' to avoid reserved keyword
+export { do_ as do };
+/**
+ * Request a human to make a decision
+ *
+ * @example
+ * ```ts
+ * const choice = await decide({
+ *   title: 'Pick deployment strategy',
+ *   options: ['blue-green', 'canary', 'rolling'],
+ *   context: { risk: 'high', users: 100000 },
+ *   assignee: 'devops-lead@example.com',
+ * })
+ * ```
+ */
+export async function decide(params) {
+    return defaultHuman.decide(params);
+}
+/**
+ * Request generation/content creation from a human
+ *
+ * This is a specialized form of do() for content generation
+ *
+ * @example
+ * ```ts
+ * const content = await generate({
+ *   title: 'Write blog post',
+ *   instructions: 'Write a blog post about our new feature',
+ *   input: { topic: 'AI Assistant', targetAudience: 'developers' },
+ *   assignee: 'content-writer@example.com',
+ * })
+ * ```
+ */
+export async function generate(params) {
+    return defaultHuman.do(params);
+}
+/**
+ * Type checking/validation request
+ *
+ * Ask a human to validate data or check type compliance
+ *
+ * @example
+ * ```ts
+ * const valid = await is({
+ *   title: 'Validate user data',
+ *   question: 'Is this user data valid and complete?',
+ *   input: userData,
+ *   assignee: 'data-specialist@example.com',
+ * })
+ * ```
+ */
+export async function is(params) {
+    const result = await defaultHuman.decide({
+        title: params.title,
+        description: params.question,
+        options: ['true', 'false'],
+        context: params.input,
+        assignee: params.assignee,
+        role: params.role,
+        team: params.team,
+        priority: params.priority,
+        timeout: params.timeout,
+        metadata: params.metadata,
+    });
+    return result === 'true';
+}
+/**
+ * Send a notification to a human
+ *
+ * @example
+ * ```ts
+ * await notify({
+ *   type: 'info',
+ *   title: 'Deployment complete',
+ *   message: 'Version 2.0.0 deployed successfully',
+ *   recipient: 'team@example.com',
+ *   channels: ['slack', 'email'],
+ * })
+ * ```
+ */
+export async function notify(params) {
+    await defaultHuman.notify(params);
+}
+/**
+ * Track Key Performance Indicators
+ *
+ * @example
+ * ```ts
+ * kpis({
+ *   id: 'monthly-revenue',
+ *   name: 'Monthly Revenue',
+ *   value: 150000,
+ *   target: 200000,
+ *   unit: 'USD',
+ *   trend: 'up',
+ * })
+ * ```
+ */
+export function kpis(kpis) {
+    return defaultHuman.trackKPIs(kpis);
+}
+/**
+ * Define Objectives and Key Results
+ *
+ * @example
+ * ```ts
+ * okrs({
+ *   id: 'q1-2024-growth',
+ *   objective: 'Accelerate user growth',
+ *   keyResults: [
+ *     {
+ *       description: 'Increase active users by 50%',
+ *       progress: 0.3,
+ *       current: 13000,
+ *       target: 15000,
+ *     },
+ *     {
+ *       description: 'Achieve 95% customer satisfaction',
+ *       progress: 0.85,
+ *       current: 0.93,
+ *       target: 0.95,
+ *     },
+ *   ],
+ *   period: 'Q1 2024',
+ *   owner: 'ceo@example.com',
+ * })
+ * ```
+ */
+export function okrs(okrs) {
+    return defaultHuman.defineOKRs(okrs);
+}
+/**
+ * Register a human worker in the system
+ *
+ * @example
+ * ```ts
+ * const alice = registerHuman({
+ *   id: 'alice',
+ *   name: 'Alice Smith',
+ *   email: 'alice@example.com',
+ *   roles: ['tech-lead', 'developer'],
+ *   teams: ['engineering', 'frontend'],
+ *   channels: {
+ *     slack: '@alice',
+ *     email: 'alice@example.com',
+ *   },
+ * })
+ * ```
+ */
+export function registerHuman(human) {
+    return defaultHuman.registerHuman(human);
+}
+/**
+ * Get the default Human manager instance
+ *
+ * Use this to access the underlying HumanManager for advanced operations
+ */
+export function getDefaultHuman() {
+    return defaultHuman;
+}
+//# sourceMappingURL=helpers.js.map

package/dist/helpers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"helpers.js","sourceRoot":"","sources":["../src/helpers.ts"],"names":[],"mappings":"AAAA;;GAEG;AAYH,OAAO,EAAE,KAAK,EAAE,MAAM,YAAY,CAAA;AAElC;;GAEG;AACH,MAAM,YAAY,GAAG,KAAK,EAAE,CAAA;AAE5B;;;;;;;;;;;;GAYG;AACH,MAAM,UAAU,IAAI,CAAC,IAAU;IAC7B,OAAO,YAAY,CAAC,UAAU,CAAC,IAAI,CAAC,CAAA;AACtC,CAAC;AAED;;;;;;;;;;;;GAYG;AACH,MAAM,UAAU,IAAI,CAAC,IAAU;IAC7B,OAAO,YAAY,CAAC,UAAU,CAAC,IAAI,CAAC,CAAA;AACtC,CAAC;AAED;;;;;;;;;;;;;;GAcG;AACH,MAAM,UAAU,KAAK,CAAC,KAAY;IAChC,OAAO,YAAY,CAAC,WAAW,CAAC,KAAK,CAAC,CAAA;AACxC,CAAC;AAED;;;;;;;;;;;;;;;;;;GAkBG;AACH,MAAM,CAAC,KAAK,UAAU,OAAO,CAAkB,MAc9C;IACC,OAAO,YAAY,CAAC,OAAO,CAAC,MAAM,CAAC,CAAA;AACrC,CAAC;AAED;;;;;;;;;;;;GAYG;AACH,MAAM,CAAC,KAAK,UAAU,GAAG,CAAC,MAWzB;IACC,OAAO,YAAY,CAAC,GAAG,CAAC,MAAM,CAAC,CAAA;AACjC,CAAC;AAED;;;;;;;;;;;;;;GAcG;AACH,MAAM,CAAC,KAAK,UAAU,GAAG,CAAsC,MAY9D;IACC,OAAO,YAAY,CAAC,EAAE,CAAC,MAAM,CAAC,CAAA;AAChC,CAAC;AAED,4EAA4E;AAC5E,OAAO,EAAE,GAAG,IAAI,EAAE,EAAE,CAAA;AAEpB;;;;;;;;;;;;GAYG;AACH,MAAM,CAAC,KAAK,UAAU,MAAM,CAAmC,MAY9D;IACC,OAAO,YAAY,CAAC,MAAM,CAAC,MAAM,CAAC,CAAA;AACpC,CAAC;AAED;;;;;;;;;;;;;;GAcG;AACH,MAAM,CAAC,KAAK,UAAU,QAAQ,CAAmB,MAUhD;IACC,OAAO,YAAY,CAAC,EAAE,CAAiB,MAAM,CAAC,CAAA;AAChD,CAAC;AAED;;;;;;;;;;;;;;GAcG;AACH,MAAM,CAAC,KAAK,UAAU,EAAE,CAAC,MAUxB;IACC,MAAM,MAAM,GAAG,MAAM,YAAY,CAAC,MAAM,CAAmB;QACzD,KAAK,EAAE,MAAM,CAAC,KAAK;QACnB,WAAW,EAAE,MAAM,CAAC,QAAQ;QAC5B,OAAO,EAAE,CAAC,MAAM,EAAE,OAAO,CAAC;QAC1B,OAAO,EAAE,MAAM,CAAC,KAAK;QACrB,QAAQ,EAAE,MAAM,CAAC,QAAQ;QACzB,IAAI,EAAE,MAAM,CAAC,IAAI;QACjB,IAAI,EAAE,MAAM,CAAC,IAAI;QACjB,QAAQ,EAAE,MAAM,CAAC,QAAQ;QACzB,OAAO,EAAE,MAAM,CAAC,OAAO;QACvB,QAAQ,EAAE,MAAM,CAAC,QAAQ;KAC1B,CAAC,CAAA;IAEF,OAAO,MAAM,KAAK,MAAM,CAAA;AAC1B,CAAC;AAED;;;;;;;;;;;;;GAaG;AACH,MAAM,CAAC,KAAK,UAAU,MAAM,CAAC,MAQ5B;IACC,MAAM,YAAY,CAAC,MAAM,CAAC,MAAM,CAAC,CAAA;AACnC,CAAC;AAED;;;;;;;;;;;;;;GAcG;AACH,MAAM,UAAU,IAAI,CAAC,IAAU;IAC7B,OAAO,YAAY,CAAC,SAAS,CAAC,IAAI,CAAC,CAAA;AACrC,CAAC;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,MAAM,UAAU,IAAI,CAAC,IAAU;IAC7B,OAAO,YAAY,CAAC,UAAU,CAAC,IAAI,CAAC,CAAA;AACtC,CAAC;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,MAAM,UAAU,aAAa,CAAC,KAAgB;IAC5C,OAAO,YAAY,CAAC,aAAa,CAAC,KAAK,CAAC,CAAA;AAC1C,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,eAAe;IAC7B,OAAO,YAAY,CAAA;AACrB,CAAC"}