@kindgi/cli 0.1.6-rc.0 → 0.1.7-rc.0

package/dist/templates/woocommerce/tools/find-orders/index.ts.tmpl

@@ -0,0 +1,80 @@
+// {{PACK_ID}}.woo.find-orders — look up orders. Read-only (`mutating:
+// false`), so the agent's approval policy lets it run without a person.
+import { defineTool } from '@kindgi/sdk/define';
+import type { ToolId } from '@kindgi/sdk/types';
+import { z } from 'zod';
+
+import { WOO_NEEDS, type WooOrder, refundedSoFar, woo } from '../../lib/woo.js';
+
+const STATUSES = [
+  'pending',
+  'processing',
+  'on-hold',
+  'completed',
+  'cancelled',
+  'refunded',
+  'failed',
+] as const;
+
+const FindOrdersInput = z.object({
+  search: z
+    .string()
+    .min(1)
+    .max(100)
+    .optional()
+    .describe('An order number, or a customer name or email address.'),
+  status: z.enum(STATUSES).optional(),
+  limit: z.number().int().min(1).max(20).default(10),
+});
+
+const Order = z.object({
+  id: z.number().int(),
+  number: z.string(),
+  status: z.string(),
+  total: z.string(),
+  /** What the order has been refunded already. */
+  refunded: z.string(),
+  currency: z.string(),
+  createdAt: z.string(),
+  /** The customer's name, never their email or address. */
+  customer: z.string(),
+});
+
+const defined = defineTool({
+  id: '{{PACK_ID}}.woo.find-orders' as ToolId,
+  description:
+    "Look up the store's orders by order number, customer name or email, or status. Read-only: it changes nothing.",
+  version: '{{PACK_VERSION}}',
+  input: FindOrdersInput,
+  output: z.object({ orders: z.array(Order) }),
+  effects: [
+    { kind: 'reads', resource: 'external:woocommerce' },
+    { kind: 'network', resource: 'external:woocommerce' },
+  ],
+  mutating: false,
+  needsSpec: WOO_NEEDS,
+  handler: async ({ search, status, limit }, ctx) => {
+    const query = new URLSearchParams({ per_page: String(limit) });
+    if (search !== undefined) query.set('search', search);
+    if (status !== undefined) query.set('status', status);
+    const orders = await woo<WooOrder[]>(ctx, 'GET', `orders?${query.toString()}`);
+    return {
+      orders: orders.map((o) => ({
+        id: o.id,
+        number: o.number,
+        status: o.status,
+        total: o.total,
+        refunded: refundedSoFar(o).toFixed(2),
+        currency: o.currency,
+        createdAt: o.date_created,
+        customer: [o.billing?.first_name, o.billing?.last_name].filter(Boolean).join(' '),
+      })),
+    };
+  },
+});
+
+if (defined.kind === 'err') {
+  throw new Error(`{{PACK_ID}}.woo.find-orders failed to compile: ${defined.error.message}`);
+}
+
+export default defined.value;

package/dist/templates/woocommerce/tools/publish-product/index.ts.tmpl

@@ -0,0 +1,34 @@
+// {{PACK_ID}}.woo.publish-product — publish a draft product, so shoppers can
+// see it. A store change, so the agent's approval policy has a person
+// approve every call.
+import { defineTool } from '@kindgi/sdk/define';
+import type { ToolId } from '@kindgi/sdk/types';
+import { z } from 'zod';
+
+import { WOO_NEEDS, woo } from '../../lib/woo.js';
+
+const defined = defineTool({
+  id: '{{PACK_ID}}.woo.publish-product' as ToolId,
+  description: 'Publish a draft product in the store. Waits for a person to approve it.',
+  version: '{{PACK_VERSION}}',
+  input: z.object({ productId: z.number().int().positive() }),
+  output: z.object({ productId: z.number().int(), name: z.string(), status: z.string() }),
+  effects: [{ kind: 'writes', resource: 'external:woocommerce' }],
+  mutating: true,
+  needsSpec: WOO_NEEDS,
+  handler: async ({ productId }, ctx) => {
+    const product = await woo<{ readonly id: number; readonly name: string; readonly status: string }>(
+      ctx,
+      'PUT',
+      `products/${productId}`,
+      { status: 'publish' },
+    );
+    return { productId: product.id, name: product.name, status: product.status };
+  },
+});
+
+if (defined.kind === 'err') {
+  throw new Error(`{{PACK_ID}}.woo.publish-product failed to compile: ${defined.error.message}`);
+}
+
+export default defined.value;

package/dist/templates/woocommerce/tools/refund/index.test.ts.tmpl

@@ -0,0 +1,125 @@
+// {{PACK_ID}}.woo.refund — the limit of 100, and each refund once, called as a
+// run calls it (`invokeToolForTest`: the input schema first, then the env
+// values Kindgi would give it, defaults included, then the handler). The
+// store is `lib/fake-store.ts`; no WooCommerce needed.
+
+import { randomUUID } from 'node:crypto';
+
+import { afterEach, describe, expect, test, vi } from 'vitest';
+
+import { invokeToolForTest } from '@kindgi/sdk/define';
+
+import { fakeStore } from '../../lib/fake-store.js';
+import { IDEMPOTENCY_META_KEY } from '../../lib/woo.js';
+import refund from './index.js';
+
+/** What `kindgi env set` and `kindgi secrets set` would give the tool. */
+const settings = {
+  env: { WOO_STORE_URL: 'http://store.test', WOO_USER: 'shop-agent' },
+  secrets: { WOO_APP_PASSWORD: 'not-a-real-password' },
+};
+
+afterEach(() => {
+  vi.unstubAllGlobals();
+});
+
+describe('{{PACK_ID}}.woo.refund', () => {
+  test('refunds 40 on an order with no refunds yet', async () => {
+    const store = fakeStore();
+    const result = await invokeToolForTest(refund, { orderId: 1043, amount: 40, reason: 'Arrived torn' }, settings);
+    expect(result).toEqual({
+      kind: 'ok',
+      value: { refundId: 501, orderId: 1043, amount: '40.00', currency: 'USD' },
+    });
+    const post = store.calls.find((c) => c.method === 'POST');
+    expect(post?.path).toBe('/wp-json/wc/v3/orders/1043/refunds');
+    // WOO_REFUND_THROUGH_GATEWAY isn't set: its default, false, applies. Outside a run
+    // there's no idempotency key, so nothing goes on the refund.
+    expect(post?.body).toEqual({ amount: '40.00', reason: 'Arrived torn', api_refund: false });
+    expect(post?.authorization).toBe(`Basic ${Buffer.from('shop-agent:not-a-real-password').toString('base64')}`);
+  });
+
+  test('refunds through the payment gateway when WOO_REFUND_THROUGH_GATEWAY is true', async () => {
+    const store = fakeStore();
+    const result = await invokeToolForTest(
+      refund,
+      { orderId: 1043, amount: 40, reason: 'Arrived torn' },
+      { ...settings, env: { ...settings.env, WOO_REFUND_THROUGH_GATEWAY: 'true' } },
+    );
+    expect(result.kind).toBe('ok');
+    expect(store.calls.find((c) => c.method === 'POST')?.body).toEqual({
+      amount: '40.00',
+      reason: 'Arrived torn',
+      api_refund: true,
+    });
+  });
+
+  test("doesn't run without the store's address, and never calls the store", async () => {
+    const store = fakeStore();
+    const result = await invokeToolForTest(
+      refund,
+      { orderId: 1043, amount: 40, reason: 'Arrived torn' },
+      { ...settings, env: { WOO_USER: 'shop-agent' } },
+    );
+    expect(result).toMatchObject({ kind: 'err', error: { code: 'precondition-failed', reason: 'env-value-missing' } });
+    expect(store.calls).toEqual([]);
+  });
+
+  test('refuses 240 at the input schema, before the store is called', async () => {
+    const store = fakeStore();
+    const result = await invokeToolForTest(refund, { orderId: 1043, amount: 240, reason: 'Arrived torn' }, settings);
+    expect(result.kind).toBe('err');
+    if (result.kind === 'err') expect(result.error.code).toBe('input-validation-failed');
+    expect(store.calls).toEqual([]);
+  });
+
+  test('refuses a refund that takes the order past 100 in total', async () => {
+    const store = fakeStore([80]);
+    const result = await invokeToolForTest(refund, { orderId: 1043, amount: 80, reason: 'Arrived torn' }, settings);
+    expect(result.kind).toBe('err');
+    if (result.kind === 'err') {
+      expect(result.error.code).toBe('handler-error');
+      expect(result.error.message).toContain('{{PACK_ID}}.woo.refund-large');
+    }
+    expect(store.calls.some((c) => c.method === 'POST')).toBe(false);
+  });
+
+  test('refunds up to exactly 100 in total', async () => {
+    fakeStore([60]);
+    const result = await invokeToolForTest(refund, { orderId: 1043, amount: 40, reason: 'Arrived torn' }, settings);
+    expect(result.kind).toBe('ok');
+  });
+
+  test('the same call run twice refunds once: the second finds the refund the first made', async () => {
+    const store = fakeStore();
+    const call = { ...settings, idempotencyKey: randomUUID() };
+    const first = await invokeToolForTest(refund, { orderId: 1043, amount: 40, reason: 'Arrived torn' }, call);
+    const again = await invokeToolForTest(refund, { orderId: 1043, amount: 40, reason: 'Arrived torn' }, call);
+    expect(first).toEqual({ kind: 'ok', value: { refundId: 501, orderId: 1043, amount: '40.00', currency: 'USD' } });
+    expect(again).toEqual(first);
+    expect(store.refunds).toHaveLength(1);
+    expect(store.refunds[0]?.meta_data).toEqual([{ key: IDEMPOTENCY_META_KEY, value: call.idempotencyKey }]);
+  });
+
+  test('a refund the store made but answered 502 for is returned as made, not refunded again', async () => {
+    const store = fakeStore();
+    store.failNextRefundAfterSaving(502);
+    const result = await invokeToolForTest(
+      refund,
+      { orderId: 1043, amount: 40, reason: 'Arrived torn' },
+      { ...settings, idempotencyKey: randomUUID() },
+    );
+    expect(result).toEqual({ kind: 'ok', value: { refundId: 501, orderId: 1043, amount: '40.00', currency: 'USD' } });
+    expect(store.refunds).toHaveLength(1);
+  });
+
+  test('a call run again after its refund reached the limit returns that refund, not a refusal', async () => {
+    const store = fakeStore([60]);
+    const call = { ...settings, idempotencyKey: randomUUID() };
+    const first = await invokeToolForTest(refund, { orderId: 1043, amount: 40, reason: 'Arrived torn' }, call);
+    const again = await invokeToolForTest(refund, { orderId: 1043, amount: 40, reason: 'Arrived torn' }, call);
+    expect(first.kind).toBe('ok');
+    expect(again).toEqual(first);
+    expect(store.refunds).toHaveLength(2);
+  });
+});

package/dist/templates/woocommerce/tools/refund/index.ts.tmpl

@@ -0,0 +1,70 @@
+// {{PACK_ID}}.woo.refund — a refund of up to 100 (in the order's currency) on
+// an order, with no one to approve it.
+//
+// Kindgi's approval rules key on the tool, not on its arguments, so "refunds
+// over 100 need a person" is two tools: this one, which the agent's policy
+// lets run on its own, and `{{PACK_ID}}.woo.refund-large`, which always waits
+// for a person. The limit is enforced here, not by the model:
+//   - the input schema caps one refund at `maximum: 100`, and Kindgi checks
+//     every call against it before the handler runs;
+//   - the handler refuses a refund that would take what the order has been
+//     refunded past 100, so splitting a large refund into small ones
+//     doesn't get around the approval.
+// Change `REFUND_LIMIT` to change the limit (the schema follows).
+import { defineTool } from '@kindgi/sdk/define';
+import type { ToolId } from '@kindgi/sdk/types';
+import { z } from 'zod';
+
+import { REFUND_NEEDS, type WooOrder, createRefund, refundedSoFar } from '../../lib/woo.js';
+
+/** The most this tool refunds on one order, in the order's currency. */
+export const REFUND_LIMIT = 100;
+
+export const RefundInput = z.object({
+  orderId: z.number().int().positive(),
+  amount: z
+    .number()
+    .positive()
+    .max(REFUND_LIMIT)
+    .describe(`At most ${REFUND_LIMIT}; a larger refund goes through the refund-large tool.`),
+  reason: z.string().min(3).max(500),
+});
+
+export const RefundOutput = z.object({
+  refundId: z.number().int(),
+  orderId: z.number().int(),
+  amount: z.string(),
+  currency: z.string(),
+});
+
+const defined = defineTool({
+  id: '{{PACK_ID}}.woo.refund' as ToolId,
+  description: `Refund up to ${REFUND_LIMIT} on an order, counting what it has been refunded already. Runs without approval. For more, use {{PACK_ID}}.woo.refund-large, which waits for a person.`,
+  version: '{{PACK_VERSION}}',
+  input: RefundInput,
+  output: RefundOutput,
+  effects: [
+    { kind: 'writes', resource: 'external:woocommerce' },
+    { kind: 'external-side-effect', notes: 'Refunds money to the customer.' },
+  ],
+  mutating: true,
+  needsSpec: REFUND_NEEDS,
+  // The limit is checked after `createRefund` has looked for this call's own
+  // refund: a call run again after its refund went out returns that refund,
+  // instead of counting it against itself.
+  handler: async (input, ctx) =>
+    createRefund(ctx, input, (order: WooOrder) => {
+      const already = refundedSoFar(order);
+      if (already + input.amount > REFUND_LIMIT) {
+        throw new Error(
+          `Order ${order.number} has been refunded ${already.toFixed(2)} already; with ${input.amount.toFixed(2)} more it passes ${REFUND_LIMIT}. Use {{PACK_ID}}.woo.refund-large, which waits for a person.`,
+        );
+      }
+    }),
+});
+
+if (defined.kind === 'err') {
+  throw new Error(`{{PACK_ID}}.woo.refund failed to compile: ${defined.error.message}`);
+}
+
+export default defined.value;

package/dist/templates/woocommerce/tools/refund-large/index.test.ts.tmpl

@@ -0,0 +1,53 @@
+// {{PACK_ID}}.woo.refund-large — any amount, once. In a run it waits for a
+// person first; here it's called as the run calls it after the approval
+// (`invokeToolForTest`). The store is `lib/fake-store.ts`.
+
+import { randomUUID } from 'node:crypto';
+
+import { afterEach, describe, expect, test, vi } from 'vitest';
+
+import { invokeToolForTest } from '@kindgi/sdk/define';
+
+import { fakeStore } from '../../lib/fake-store.js';
+import refundLarge from './index.js';
+
+/** What `kindgi env set` and `kindgi secrets set` would give the tool. */
+const settings = {
+  env: { WOO_STORE_URL: 'http://store.test', WOO_USER: 'shop-agent' },
+  secrets: { WOO_APP_PASSWORD: 'not-a-real-password' },
+};
+
+afterEach(() => {
+  vi.unstubAllGlobals();
+});
+
+describe('{{PACK_ID}}.woo.refund-large', () => {
+  test('refunds 240, past the limit of the refund tool', async () => {
+    const store = fakeStore();
+    const result = await invokeToolForTest(refundLarge, { orderId: 1043, amount: 240, reason: 'Zip broke on day one' }, settings);
+    expect(result).toEqual({ kind: 'ok', value: { refundId: 501, orderId: 1043, amount: '240.00', currency: 'USD' } });
+    expect(store.refunds).toHaveLength(1);
+  });
+
+  test('the step resumed after its approval, or run again after a crash, refunds once', async () => {
+    const store = fakeStore();
+    const call = { ...settings, idempotencyKey: randomUUID() };
+    const first = await invokeToolForTest(refundLarge, { orderId: 1043, amount: 240, reason: 'Zip broke on day one' }, call);
+    const again = await invokeToolForTest(refundLarge, { orderId: 1043, amount: 240, reason: 'Zip broke on day one' }, call);
+    expect(first.kind).toBe('ok');
+    expect(again).toEqual(first);
+    expect(store.refunds).toHaveLength(1);
+  });
+
+  test('a refund the store made but answered 502 for is returned as made', async () => {
+    const store = fakeStore();
+    store.failNextRefundAfterSaving(502);
+    const result = await invokeToolForTest(
+      refundLarge,
+      { orderId: 1043, amount: 240, reason: 'Zip broke on day one' },
+      { ...settings, idempotencyKey: randomUUID() },
+    );
+    expect(result).toEqual({ kind: 'ok', value: { refundId: 501, orderId: 1043, amount: '240.00', currency: 'USD' } });
+    expect(store.refunds).toHaveLength(1);
+  });
+});

package/dist/templates/woocommerce/tools/refund-large/index.ts.tmpl

@@ -0,0 +1,44 @@
+// {{PACK_ID}}.woo.refund-large — a refund of any amount on an order. The
+// agent's approval policy marks it `always_ask`: every call waits for a
+// person to approve it, and the refund happens only after they do, once:
+// the step resumed after the approval, or run again after a crash, finds the
+// refund it made (`createRefund` in `lib/woo.ts`). See
+// `{{PACK_ID}}.woo.refund` for why the store has two refund tools.
+import { defineTool } from '@kindgi/sdk/define';
+import type { ToolId } from '@kindgi/sdk/types';
+import { z } from 'zod';
+
+import { REFUND_NEEDS, createRefund } from '../../lib/woo.js';
+
+const RefundLargeInput = z.object({
+  orderId: z.number().int().positive(),
+  amount: z.number().positive(),
+  reason: z.string().min(3).max(500),
+});
+
+const defined = defineTool({
+  id: '{{PACK_ID}}.woo.refund-large' as ToolId,
+  description:
+    'Refund any amount on an order. Waits for a person to approve it before anything is refunded.',
+  version: '{{PACK_VERSION}}',
+  input: RefundLargeInput,
+  output: z.object({
+    refundId: z.number().int(),
+    orderId: z.number().int(),
+    amount: z.string(),
+    currency: z.string(),
+  }),
+  effects: [
+    { kind: 'writes', resource: 'external:woocommerce' },
+    { kind: 'external-side-effect', notes: 'Refunds money to the customer.' },
+  ],
+  mutating: true,
+  needsSpec: REFUND_NEEDS,
+  handler: async (input, ctx) => createRefund(ctx, input),
+});
+
+if (defined.kind === 'err') {
+  throw new Error(`{{PACK_ID}}.woo.refund-large failed to compile: ${defined.error.message}`);
+}
+
+export default defined.value;

package/dist/templates/woocommerce/tools/set-price/index.ts.tmpl

@@ -0,0 +1,36 @@
+// {{PACK_ID}}.woo.set-price — change a product's regular price. A store
+// change, so the agent's approval policy has a person approve every call.
+import { defineTool } from '@kindgi/sdk/define';
+import type { ToolId } from '@kindgi/sdk/types';
+import { z } from 'zod';
+
+import { WOO_NEEDS, woo } from '../../lib/woo.js';
+
+const defined = defineTool({
+  id: '{{PACK_ID}}.woo.set-price' as ToolId,
+  description: "Change a product's regular price. Waits for a person to approve it.",
+  version: '{{PACK_VERSION}}',
+  input: z.object({
+    productId: z.number().int().positive(),
+    regularPrice: z.number().positive(),
+  }),
+  output: z.object({ productId: z.number().int(), name: z.string(), regularPrice: z.string() }),
+  effects: [{ kind: 'writes', resource: 'external:woocommerce' }],
+  mutating: true,
+  needsSpec: WOO_NEEDS,
+  handler: async ({ productId, regularPrice }, ctx) => {
+    const product = await woo<{ readonly id: number; readonly name: string; readonly regular_price: string }>(
+      ctx,
+      'PUT',
+      `products/${productId}`,
+      { regular_price: regularPrice.toFixed(2) },
+    );
+    return { productId: product.id, name: product.name, regularPrice: product.regular_price };
+  },
+});
+
+if (defined.kind === 'err') {
+  throw new Error(`{{PACK_ID}}.woo.set-price failed to compile: ${defined.error.message}`);
+}
+
+export default defined.value;

package/dist/templates/woocommerce/tsconfig.json.tmpl

@@ -0,0 +1,28 @@
+{
+  "compilerOptions": {
+    "target": "ES2023",
+    "module": "NodeNext",
+    "moduleResolution": "NodeNext",
+    "lib": ["ES2023", "DOM"],
+    "types": ["node"],
+    "strict": true,
+    "esModuleInterop": true,
+    "skipLibCheck": true,
+    "verbatimModuleSyntax": true,
+    "isolatedModules": true,
+    "declaration": true,
+    "sourceMap": true,
+    "noEmit": true,
+    "resolveJsonModule": true,
+    "forceConsistentCasingInFileNames": true
+  },
+  "include": [
+    "lib/**/*.ts",
+    "tools/**/*.ts",
+    "guardrails/**/*.ts",
+    "agents/**/*.ts",
+    "flows/**/*.ts",
+    "kindgi.config.ts"
+  ],
+  "exclude": ["node_modules", "dist", ".kindgi"]
+}

package/dist/templates/woocommerce/vitest.config.ts.tmpl

@@ -0,0 +1,14 @@
+// Vitest configuration for {{PACK_NAME}}. Scaffolded by `kindgi init`.
+// `kindgi test` shells out to the pack's local vitest install using
+// this config — the CLI does NOT force a vitest version through.
+
+import { defineConfig } from 'vitest/config';
+
+export default defineConfig({
+  test: {
+    include: ['**/*.test.ts'],
+    exclude: ['node_modules/**', '.kindgi/**', 'dist/**'],
+    reporters: ['default'],
+    passWithNoTests: true,
+  },
+});

package/dist/test/defaults.d.ts

@@ -1,3 +1,3 @@
-import type { TestRunners } from './runners.js';
+import { type TestRunners } from './runners.js';
 export declare const REAL_TEST_RUNNERS: TestRunners;
 //# sourceMappingURL=defaults.d.ts.map

package/dist/test/defaults.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"defaults.d.ts","sourceRoot":"","sources":["../../src/test/defaults.ts"],"names":[],"mappings":"AAeA,OAAO,KAAK,EAAmC,WAAW,EAAE,MAAM,cAAc,CAAC;AASjF,eAAO,MAAM,iBAAiB,EAAE,WAc/B,CAAC"}
+{"version":3,"file":"defaults.d.ts","sourceRoot":"","sources":["../../src/test/defaults.ts"],"names":[],"mappings":"AAeA,OAAO,EAGL,KAAK,WAAW,EAEjB,MAAM,cAAc,CAAC;AAEtB,eAAO,MAAM,iBAAiB,EAAE,WAc/B,CAAC"}

package/dist/test/defaults.js

@@ -10,15 +10,10 @@
 import { spawn } from 'node:child_process';
 import { stat } from 'node:fs/promises';
 import { join } from 'node:path';
-const VITEST_CONFIGS = [
-    'vitest.config.ts',
-    'vitest.config.mjs',
-    'vitest.config.js',
-    'vitest.config.cjs',
-];
+import { VITEST_CONFIG_FILENAMES, } from './runners.js';
 export const REAL_TEST_RUNNERS = {
     hasVitestConfig: async ({ packDir }) => {
-        for (const name of VITEST_CONFIGS) {
+        for (const name of VITEST_CONFIG_FILENAMES) {
             const abs = join(packDir, name);
             try {
                 const s = await stat(abs);

package/dist/test/defaults.js.map

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

package/dist/test/runners.d.ts

@@ -3,6 +3,12 @@
  * flows through this shape so tests inspect the invocation without
  * spawning real vitest.
  */
+/**
+ * vitest's own config file names, in the order it looks for them
+ * (`vite.config.*` aside: one often has no `test` block, and vitest then
+ * sweeps every test file under the folder).
+ */
+export declare const VITEST_CONFIG_FILENAMES: readonly ["vitest.config.ts", "vitest.config.mts", "vitest.config.cts", "vitest.config.js", "vitest.config.mjs", "vitest.config.cjs"];
 export interface RunTestsOptions {
     /** Absolute pack directory the runner spawns in. */
     readonly packDir: string;

package/dist/test/runners.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"runners.d.ts","sourceRoot":"","sources":["../../src/test/runners.ts"],"names":[],"mappings":"AAGA;;;;GAIG;AAEH,MAAM,WAAW,eAAe;IAC9B,oDAAoD;IACpD,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,+DAA+D;IAC/D,QAAQ,CAAC,MAAM,EAAE,QAAQ,CAAC;IAC1B;;;OAGG;IACH,QAAQ,CAAC,IAAI,EAAE,SAAS,MAAM,EAAE,CAAC;IACjC,8CAA8C;IAC9C,QAAQ,CAAC,GAAG,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC,CAAC,CAAC;IAC3D;;;OAGG;IACH,QAAQ,CAAC,MAAM,CAAC,EAAE,WAAW,CAAC;IAC9B;;;OAGG;IACH,QAAQ,CAAC,KAAK,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;CAC1C;AAED,MAAM,WAAW,cAAc;IAC7B,iEAAiE;IACjE,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B;;;;OAIG;IACH,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAC1B,oEAAoE;IACpE,QAAQ,CAAC,MAAM,CAAC,EAAE,yBAAyB,GAAG,oBAAoB,CAAC;IACnE,mEAAmE;IACnE,QAAQ,CAAC,cAAc,CAAC,EAAE,MAAM,CAAC;CAClC;AAED,MAAM,WAAW,sBAAsB;IACrC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;CAC1B;AAED,MAAM,WAAW,WAAW;IAC1B;;;;;OAKG;IACH,QAAQ,CAAC,eAAe,EAAE,CAAC,IAAI,EAAE,sBAAsB,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC;IAC7E;;;OAGG;IACH,QAAQ,CAAC,QAAQ,EAAE,CAAC,IAAI,EAAE,eAAe,KAAK,OAAO,CAAC,cAAc,CAAC,CAAC;CACvE"}
+{"version":3,"file":"runners.d.ts","sourceRoot":"","sources":["../../src/test/runners.ts"],"names":[],"mappings":"AAGA;;;;GAIG;AAEH;;;;GAIG;AACH,eAAO,MAAM,uBAAuB,uIAO1B,CAAC;AAEX,MAAM,WAAW,eAAe;IAC9B,oDAAoD;IACpD,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,+DAA+D;IAC/D,QAAQ,CAAC,MAAM,EAAE,QAAQ,CAAC;IAC1B;;;OAGG;IACH,QAAQ,CAAC,IAAI,EAAE,SAAS,MAAM,EAAE,CAAC;IACjC,8CAA8C;IAC9C,QAAQ,CAAC,GAAG,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC,CAAC,CAAC;IAC3D;;;OAGG;IACH,QAAQ,CAAC,MAAM,CAAC,EAAE,WAAW,CAAC;IAC9B;;;OAGG;IACH,QAAQ,CAAC,KAAK,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;CAC1C;AAED,MAAM,WAAW,cAAc;IAC7B,iEAAiE;IACjE,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B;;;;OAIG;IACH,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAC1B,oEAAoE;IACpE,QAAQ,CAAC,MAAM,CAAC,EAAE,yBAAyB,GAAG,oBAAoB,CAAC;IACnE,mEAAmE;IACnE,QAAQ,CAAC,cAAc,CAAC,EAAE,MAAM,CAAC;CAClC;AAED,MAAM,WAAW,sBAAsB;IACrC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;CAC1B;AAED,MAAM,WAAW,WAAW;IAC1B;;;;;OAKG;IACH,QAAQ,CAAC,eAAe,EAAE,CAAC,IAAI,EAAE,sBAAsB,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC;IAC7E;;;OAGG;IACH,QAAQ,CAAC,QAAQ,EAAE,CAAC,IAAI,EAAE,eAAe,KAAK,OAAO,CAAC,cAAc,CAAC,CAAC;CACvE"}

package/dist/test/runners.js

@@ -1,4 +1,21 @@
 // SPDX-License-Identifier: Apache-2.0
 // Copyright (C) 2026 Kindgi Inc.
-export {};
+/**
+ * Injectable seams for `kindgi test`. The test-runner shellout
+ * flows through this shape so tests inspect the invocation without
+ * spawning real vitest.
+ */
+/**
+ * vitest's own config file names, in the order it looks for them
+ * (`vite.config.*` aside: one often has no `test` block, and vitest then
+ * sweeps every test file under the folder).
+ */
+export const VITEST_CONFIG_FILENAMES = [
+    'vitest.config.ts',
+    'vitest.config.mts',
+    'vitest.config.cts',
+    'vitest.config.js',
+    'vitest.config.mjs',
+    'vitest.config.cjs',
+];
 //# sourceMappingURL=runners.js.map

package/dist/test/runners.js.map

@@ -1 +1 @@
-{"version":3,"file":"runners.js","sourceRoot":"","sources":["../../src/test/runners.ts"],"names":[],"mappings":"AAAA,sCAAsC;AACtC,iCAAiC"}
+{"version":3,"file":"runners.js","sourceRoot":"","sources":["../../src/test/runners.ts"],"names":[],"mappings":"AAAA,sCAAsC;AACtC,iCAAiC;AAEjC;;;;GAIG;AAEH;;;;GAIG;AACH,MAAM,CAAC,MAAM,uBAAuB,GAAG;IACrC,kBAAkB;IAClB,mBAAmB;IACnB,mBAAmB;IACnB,kBAAkB;IAClB,mBAAmB;IACnB,mBAAmB;CACX,CAAC"}

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@kindgi/cli",
-  "version": "0.1.6-rc.0",
-  "description": "Command-line interface for Kindgi™ — the sovereign AI OS. Create a pack, run it on your machine (`kindgi dev`), build, sign and deploy it, and work with a running Kindgi API from the terminal.",
+  "version": "0.1.7-rc.0",
+  "description": "Command-line interface for Kindgi™. Create a pack, run it on your machine (`kindgi dev`), build, sign and deploy it, and work with a running Kindgi API from the terminal.",
   "license": "Apache-2.0",
   "repository": {
     "type": "git",
@@ -37,18 +37,18 @@
     "provenance": true
   },
   "dependencies": {
-    "@kindgi/agents": "0.1.6-rc.0",
-    "@kindgi/client": "0.1.6-rc.0",
-    "@kindgi/dotenv-file": "0.1.6-rc.0",
-    "@kindgi/crypto": "0.1.6-rc.0",
-    "@kindgi/env-schema": "0.1.6-rc.0",
-    "@kindgi/flow": "0.1.6-rc.0",
-    "@kindgi/handler-runtime": "0.1.6-rc.0",
-    "@kindgi/log": "0.1.6-rc.0",
-    "@kindgi/secrets-dotenv": "0.1.6-rc.0",
-    "@kindgi/platform": "0.1.6-rc.0",
-    "@kindgi/sdk": "0.1.6-rc.0",
-    "@kindgi/types": "0.1.6-rc.0",
+    "@kindgi/agents": "0.1.7-rc.0",
+    "@kindgi/client": "0.1.7-rc.0",
+    "@kindgi/dotenv-file": "0.1.7-rc.0",
+    "@kindgi/crypto": "0.1.7-rc.0",
+    "@kindgi/env-schema": "0.1.7-rc.0",
+    "@kindgi/flow": "0.1.7-rc.0",
+    "@kindgi/handler-runtime": "0.1.7-rc.0",
+    "@kindgi/log": "0.1.7-rc.0",
+    "@kindgi/secrets-dotenv": "0.1.7-rc.0",
+    "@kindgi/platform": "0.1.7-rc.0",
+    "@kindgi/sdk": "0.1.7-rc.0",
+    "@kindgi/types": "0.1.7-rc.0",
     "esbuild": "^0.24.0",
     "semver": "^7.8.5",
     "smol-toml": "^1.9.0",