@pikku/inspector 0.12.75 → 0.12.81
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/CHANGELOG.md +330 -0
- package/dist/add/add-analytics.d.ts +9 -0
- package/dist/add/add-analytics.js +178 -0
- package/dist/add/add-auth.js +0 -54
- package/dist/add/add-feature-flag.d.ts +2 -0
- package/dist/add/add-feature-flag.js +162 -0
- package/dist/add/add-wire-addon.js +1 -0
- package/dist/add/add-wire-remote-addon.js +1 -0
- package/dist/index.d.ts +3 -1
- package/dist/index.js +3 -1
- package/dist/inspector.js +4 -0
- package/dist/surface/collect-surface.d.ts +58 -0
- package/dist/surface/collect-surface.js +613 -0
- package/dist/types.d.ts +20 -11
- package/dist/utils/filter-inspector-state.js +14 -0
- package/dist/utils/post-process.js +15 -0
- package/dist/utils/read-module-specifiers.d.ts +8 -0
- package/dist/utils/read-module-specifiers.js +23 -0
- package/dist/utils/read-tsconfig-out-dir.d.ts +5 -0
- package/dist/utils/read-tsconfig-out-dir.js +12 -0
- package/dist/utils/resolve-deploy-target.d.ts +7 -0
- package/dist/utils/resolve-deploy-target.js +15 -7
- package/dist/utils/serialize-inspector-state.d.ts +5 -0
- package/dist/utils/serialize-inspector-state.js +8 -0
- package/dist/visit.js +4 -0
- package/package.json +16 -6
- package/run-tests.sh +21 -6
- package/src/add/add-addon-bans.ts +0 -85
- package/src/add/add-agent-scorer.test.ts +0 -197
- package/src/add/add-agent-scorer.ts +0 -83
- package/src/add/add-agent.test.ts +0 -87
- package/src/add/add-agent.ts +0 -638
- package/src/add/add-approval-description.ts +0 -76
- package/src/add/add-auth.test.ts +0 -791
- package/src/add/add-auth.ts +0 -424
- package/src/add/add-channel.ts +0 -778
- package/src/add/add-cli-renderers.test.ts +0 -74
- package/src/add/add-cli.ts +0 -1006
- package/src/add/add-credential.ts +0 -186
- package/src/add/add-feature.test.ts +0 -306
- package/src/add/add-feature.ts +0 -253
- package/src/add/add-file-extends-core-type.ts +0 -66
- package/src/add/add-file-with-config.ts +0 -45
- package/src/add/add-file-with-factory.test.ts +0 -134
- package/src/add/add-file-with-factory.ts +0 -288
- package/src/add/add-functions.test.ts +0 -743
- package/src/add/add-functions.ts +0 -1548
- package/src/add/add-gateway.ts +0 -143
- package/src/add/add-http-route-ref.test.ts +0 -149
- package/src/add/add-http-route.ts +0 -530
- package/src/add/add-http-routes.ts +0 -471
- package/src/add/add-keyed-wiring.ts +0 -180
- package/src/add/add-mcp-prompt.ts +0 -157
- package/src/add/add-mcp-resource.ts +0 -175
- package/src/add/add-middleware.test.ts +0 -196
- package/src/add/add-middleware.ts +0 -879
- package/src/add/add-permission-auth.test.ts +0 -59
- package/src/add/add-permission.ts +0 -311
- package/src/add/add-personas.test.ts +0 -406
- package/src/add/add-personas.ts +0 -287
- package/src/add/add-queue-worker.ts +0 -117
- package/src/add/add-rpc-invocations.test.ts +0 -287
- package/src/add/add-rpc-invocations.ts +0 -221
- package/src/add/add-scenario-step.test.ts +0 -509
- package/src/add/add-schedule.ts +0 -120
- package/src/add/add-scope.test.ts +0 -419
- package/src/add/add-scope.ts +0 -221
- package/src/add/add-secret.ts +0 -10
- package/src/add/add-subject-scenario-steps.test.ts +0 -161
- package/src/add/add-system-role.test.ts +0 -297
- package/src/add/add-system-role.ts +0 -162
- package/src/add/add-trigger.ts +0 -165
- package/src/add/add-variable.ts +0 -10
- package/src/add/add-wire-addon.test.ts +0 -185
- package/src/add/add-wire-addon.ts +0 -146
- package/src/add/add-wire-remote-addon.ts +0 -80
- package/src/add/add-workflow-edge-cases.test.ts +0 -201
- package/src/add/add-workflow-fanout.test.ts +0 -166
- package/src/add/add-workflow-graph-foreach.test.ts +0 -174
- package/src/add/add-workflow-graph-input.test.ts +0 -94
- package/src/add/add-workflow-graph-notes.test.ts +0 -74
- package/src/add/add-workflow-graph.ts +0 -644
- package/src/add/add-workflow-on-error.test.ts +0 -118
- package/src/add/add-workflow-return-switch.test.ts +0 -121
- package/src/add/add-workflow-silent-drops.test.ts +0 -261
- package/src/add/add-workflow-sleep-expression.test.ts +0 -96
- package/src/add/add-workflow.test.ts +0 -155
- package/src/add/add-workflow.ts +0 -482
- package/src/add/addon-bans.test.ts +0 -121
- package/src/add/addon-contracts.test.ts +0 -221
- package/src/add/allow-escape-hatches.test.ts +0 -144
- package/src/add/audit-meta.test.ts +0 -75
- package/src/add/classified-sink-check.test.ts +0 -347
- package/src/add/config-value-metadata.test.ts +0 -263
- package/src/add/dynamic-import-check.test.ts +0 -119
- package/src/add/expect-eventually-scenario-only.test.ts +0 -108
- package/src/add/function-body-span.test.ts +0 -96
- package/src/add/inline-wiring-function.test.ts +0 -104
- package/src/add/pii-check.test.ts +0 -258
- package/src/add/rpc-type-cast.test.ts +0 -123
- package/src/add/scenario-instrumentation.test.ts +0 -89
- package/src/add/scenario-instrumentation.ts +0 -42
- package/src/add/scenario-marker.test.ts +0 -89
- package/src/add/scenario-not-extractable.test.ts +0 -159
- package/src/add/scenario-services.test.ts +0 -103
- package/src/add/scenario-skip.test.ts +0 -83
- package/src/add/validate-workflow-graph-addons.test.ts +0 -102
- package/src/add/wire-name-literal.test.ts +0 -117
- package/src/error-codes-emitted.test.ts +0 -76
- package/src/error-codes.ts +0 -145
- package/src/index.ts +0 -66
- package/src/inspector.ts +0 -575
- package/src/schema-generator.ts +0 -1
- package/src/source-file-cache.ts +0 -73
- package/src/tsconfig-paths.test.ts +0 -90
- package/src/types-map.ts +0 -141
- package/src/types.ts +0 -775
- package/src/utils/annotate-http-route-auth.test.ts +0 -161
- package/src/utils/annotate-http-route-auth.ts +0 -53
- package/src/utils/check-classified-sinks.ts +0 -215
- package/src/utils/check-pii-output.ts +0 -120
- package/src/utils/compute-diagnostics.test.ts +0 -106
- package/src/utils/compute-required-schemas.ts +0 -48
- package/src/utils/contract-hashes.test.ts +0 -553
- package/src/utils/contract-hashes.ts +0 -387
- package/src/utils/custom-types-generator.test.ts +0 -124
- package/src/utils/custom-types-generator.ts +0 -150
- package/src/utils/detect-schema-vendor.test.ts +0 -123
- package/src/utils/detect-schema-vendor.ts +0 -120
- package/src/utils/does-type-extend-core-type.ts +0 -53
- package/src/utils/ensure-function-metadata.ts +0 -385
- package/src/utils/extract-function-name.ts +0 -612
- package/src/utils/extract-function-node.ts +0 -70
- package/src/utils/extract-node-value.test.ts +0 -117
- package/src/utils/extract-node-value.ts +0 -172
- package/src/utils/extract-secret-usage.test.ts +0 -81
- package/src/utils/extract-secret-usage.ts +0 -73
- package/src/utils/extract-services.ts +0 -70
- package/src/utils/extract-surface-usage.test.ts +0 -147
- package/src/utils/extract-surface-usage.ts +0 -121
- package/src/utils/filter-inspector-state.test.ts +0 -2232
- package/src/utils/filter-inspector-state.ts +0 -1298
- package/src/utils/filter-utils.test.ts +0 -843
- package/src/utils/filter-utils.ts +0 -161
- package/src/utils/find-root-dir.ts +0 -68
- package/src/utils/find-zod-transform.test.ts +0 -70
- package/src/utils/find-zod-transform.ts +0 -103
- package/src/utils/get-exported-variable-name.ts +0 -48
- package/src/utils/get-files-and-methods.ts +0 -157
- package/src/utils/get-property-value.test.ts +0 -141
- package/src/utils/get-property-value.ts +0 -331
- package/src/utils/hash.ts +0 -26
- package/src/utils/literal-properties.ts +0 -97
- package/src/utils/load-addon-functions-meta.test.ts +0 -157
- package/src/utils/load-addon-functions-meta.ts +0 -508
- package/src/utils/load-addon-scopes.test.ts +0 -138
- package/src/utils/middleware.test.ts +0 -204
- package/src/utils/middleware.ts +0 -303
- package/src/utils/nested-project-filter.test.ts +0 -53
- package/src/utils/nested-project-filter.ts +0 -28
- package/src/utils/permissions-shorthand.test.ts +0 -79
- package/src/utils/permissions.test.ts +0 -125
- package/src/utils/permissions.ts +0 -129
- package/src/utils/post-process.test.ts +0 -1094
- package/src/utils/post-process.ts +0 -1604
- package/src/utils/resolve-addon-package.ts +0 -106
- package/src/utils/resolve-core-type.test.ts +0 -142
- package/src/utils/resolve-core-type.ts +0 -35
- package/src/utils/resolve-deploy-target.test.ts +0 -135
- package/src/utils/resolve-deploy-target.ts +0 -65
- package/src/utils/resolve-function-meta.ts +0 -25
- package/src/utils/resolve-function-types.ts +0 -42
- package/src/utils/resolve-identifier.ts +0 -46
- package/src/utils/resolve-ref-contract.ts +0 -71
- package/src/utils/resolve-versions.test.ts +0 -499
- package/src/utils/resolve-versions.ts +0 -228
- package/src/utils/schema-cache.test.ts +0 -124
- package/src/utils/schema-generator.test.ts +0 -272
- package/src/utils/schema-generator.ts +0 -780
- package/src/utils/secret-alias-services.test.ts +0 -146
- package/src/utils/secret-alias-services.ts +0 -58
- package/src/utils/serialize-inspector-state.ts +0 -742
- package/src/utils/serialize-mcp-json.ts +0 -150
- package/src/utils/serialize-middleware-groups-meta.ts +0 -36
- package/src/utils/serialize-openapi-json.ts +0 -277
- package/src/utils/serialize-permissions-groups-meta.ts +0 -7
- package/src/utils/single-declaration.ts +0 -57
- package/src/utils/type-utils.ts +0 -145
- package/src/utils/validate-auth-sessionless.ts +0 -30
- package/src/utils/validate-exposed-functions-gated.test.ts +0 -230
- package/src/utils/validate-exposed-functions-gated.ts +0 -103
- package/src/utils/validate-tags-resolve-to-middleware.test.ts +0 -108
- package/src/utils/validate-tags-resolve-to-middleware.ts +0 -48
- package/src/utils/workflow/derive-workflow-plan.test.ts +0 -178
- package/src/utils/workflow/derive-workflow-plan.ts +0 -117
- package/src/utils/workflow/dsl/deserialize-dsl-workflow.ts +0 -1465
- package/src/utils/workflow/dsl/deserialize-fanout-body.test.ts +0 -71
- package/src/utils/workflow/dsl/deserialize-fanout-fidelity.test.ts +0 -99
- package/src/utils/workflow/dsl/deserialize-graph-next.test.ts +0 -161
- package/src/utils/workflow/dsl/deserialize-roundtrip-bindings.test.ts +0 -121
- package/src/utils/workflow/dsl/deserialize-roundtrip-values.test.ts +0 -116
- package/src/utils/workflow/dsl/deserialize-roundtrip.test.ts +0 -145
- package/src/utils/workflow/dsl/extract-approval-policy.test.ts +0 -71
- package/src/utils/workflow/dsl/extract-dsl-workflow.ts +0 -2254
- package/src/utils/workflow/dsl/index.ts +0 -11
- package/src/utils/workflow/dsl/patterns.ts +0 -440
- package/src/utils/workflow/dsl/validation.ts +0 -203
- package/src/utils/workflow/graph/convert-dsl-to-graph-skip.test.ts +0 -35
- package/src/utils/workflow/graph/convert-dsl-to-graph.ts +0 -543
- package/src/utils/workflow/graph/fanout-node-identity.test.ts +0 -105
- package/src/utils/workflow/graph/finalize-workflow-wires.ts +0 -310
- package/src/utils/workflow/graph/finalize-workflows.test.ts +0 -50
- package/src/utils/workflow/graph/finalize-workflows.ts +0 -130
- package/src/utils/workflow/graph/index.ts +0 -28
- package/src/utils/workflow/graph/serialize-workflow-graph.ts +0 -240
- package/src/utils/workflow/graph/workflow-graph.types.ts +0 -281
- package/src/visit.ts +0 -181
- package/tsconfig.json +0 -19
- package/tsconfig.tsbuildinfo +0 -1
|
@@ -1,83 +0,0 @@
|
|
|
1
|
-
import * as ts from 'typescript'
|
|
2
|
-
import { getPropertyValue } from '../utils/get-property-value.js'
|
|
3
|
-
import type { AddWiring } from '../types.js'
|
|
4
|
-
import { extractFunctionName } from '../utils/extract-function-name.js'
|
|
5
|
-
import { ErrorCode } from '../error-codes.js'
|
|
6
|
-
|
|
7
|
-
/**
|
|
8
|
-
* `pikkuAgentScorer` grades in code and `pikkuAgentJudge` grades with a model, which
|
|
9
|
-
* is the whole difference between the two lanes — so the lane is read off which
|
|
10
|
-
* constructor was called rather than from a field an author could contradict.
|
|
11
|
-
*/
|
|
12
|
-
const LANES: Record<string, 'fast' | 'slow'> = {
|
|
13
|
-
pikkuAgentScorer: 'fast',
|
|
14
|
-
pikkuAgentJudge: 'slow',
|
|
15
|
-
}
|
|
16
|
-
|
|
17
|
-
export const addAgentScorer: AddWiring = (logger, node, checker, state) => {
|
|
18
|
-
if (!ts.isCallExpression(node)) return
|
|
19
|
-
|
|
20
|
-
const expression = node.expression
|
|
21
|
-
if (!ts.isIdentifier(expression)) return
|
|
22
|
-
|
|
23
|
-
const lane = LANES[expression.text]
|
|
24
|
-
if (!lane) return
|
|
25
|
-
|
|
26
|
-
const firstArg = node.arguments[0]
|
|
27
|
-
if (!firstArg || !ts.isObjectLiteralExpression(firstArg)) return
|
|
28
|
-
|
|
29
|
-
const obj = firstArg
|
|
30
|
-
const { exportedName } = extractFunctionName(node, checker, state.rootDir)
|
|
31
|
-
|
|
32
|
-
const nameValue = getPropertyValue(obj, 'name') as string | null
|
|
33
|
-
if (!nameValue) {
|
|
34
|
-
logger.critical(
|
|
35
|
-
ErrorCode.MISSING_NAME,
|
|
36
|
-
"AI scorer is missing the required 'name' property."
|
|
37
|
-
)
|
|
38
|
-
return
|
|
39
|
-
}
|
|
40
|
-
|
|
41
|
-
const description = getPropertyValue(obj, 'description') as string | null
|
|
42
|
-
if (!description) {
|
|
43
|
-
logger.critical(
|
|
44
|
-
ErrorCode.MISSING_DESCRIPTION,
|
|
45
|
-
`AI scorer '${nameValue}' is missing the required 'description' property.`
|
|
46
|
-
)
|
|
47
|
-
return
|
|
48
|
-
}
|
|
49
|
-
|
|
50
|
-
const sampleRateValue = getPropertyValue(obj, 'sampleRate') as number | null
|
|
51
|
-
if (
|
|
52
|
-
sampleRateValue !== null &&
|
|
53
|
-
(sampleRateValue < 0 || sampleRateValue > 1)
|
|
54
|
-
) {
|
|
55
|
-
logger.critical(
|
|
56
|
-
ErrorCode.INVALID_VALUE,
|
|
57
|
-
`AI scorer '${nameValue}' has a sampleRate of ${sampleRateValue} — it is the fraction of live runs to grade, so it must be between 0 and 1.`
|
|
58
|
-
)
|
|
59
|
-
return
|
|
60
|
-
}
|
|
61
|
-
|
|
62
|
-
const requiresReference =
|
|
63
|
-
(getPropertyValue(obj, 'requiresReference') as boolean | null) ?? false
|
|
64
|
-
|
|
65
|
-
const scorerKey = exportedName || nameValue
|
|
66
|
-
|
|
67
|
-
if (exportedName) {
|
|
68
|
-
state.scorers.files.set(scorerKey, {
|
|
69
|
-
path: node.getSourceFile().fileName,
|
|
70
|
-
exportedName,
|
|
71
|
-
})
|
|
72
|
-
}
|
|
73
|
-
|
|
74
|
-
state.scorers.scorersMeta[scorerKey] = {
|
|
75
|
-
name: nameValue,
|
|
76
|
-
description,
|
|
77
|
-
lane,
|
|
78
|
-
sampleRate: sampleRateValue ?? 1,
|
|
79
|
-
requiresReference,
|
|
80
|
-
sourceFile: node.getSourceFile().fileName,
|
|
81
|
-
exportedName: exportedName || undefined,
|
|
82
|
-
}
|
|
83
|
-
}
|
|
@@ -1,87 +0,0 @@
|
|
|
1
|
-
import { describe, test } from 'node:test'
|
|
2
|
-
import assert from 'node:assert'
|
|
3
|
-
import * as ts from 'typescript'
|
|
4
|
-
|
|
5
|
-
import { resolveWorkflowReferences } from './add-agent.js'
|
|
6
|
-
import type { InspectorLogger } from '../types.js'
|
|
7
|
-
|
|
8
|
-
function createSourceFile(code: string): ts.SourceFile {
|
|
9
|
-
return ts.createSourceFile('test.ts', code, ts.ScriptTarget.ESNext, true)
|
|
10
|
-
}
|
|
11
|
-
|
|
12
|
-
function getObjectLiteral(
|
|
13
|
-
sourceFile: ts.SourceFile
|
|
14
|
-
): ts.ObjectLiteralExpression {
|
|
15
|
-
let result: ts.ObjectLiteralExpression | undefined
|
|
16
|
-
ts.forEachChild(sourceFile, function visit(node) {
|
|
17
|
-
if (ts.isObjectLiteralExpression(node) && !result) {
|
|
18
|
-
result = node
|
|
19
|
-
}
|
|
20
|
-
ts.forEachChild(node, visit)
|
|
21
|
-
})
|
|
22
|
-
if (!result) throw new Error('No object literal found')
|
|
23
|
-
return result
|
|
24
|
-
}
|
|
25
|
-
|
|
26
|
-
function createLogger(): {
|
|
27
|
-
logger: InspectorLogger
|
|
28
|
-
criticals: Array<{ code: unknown; message: string }>
|
|
29
|
-
} {
|
|
30
|
-
const criticals: Array<{ code: unknown; message: string }> = []
|
|
31
|
-
const logger = {
|
|
32
|
-
info: () => {},
|
|
33
|
-
error: () => {},
|
|
34
|
-
warn: () => {},
|
|
35
|
-
debug: () => {},
|
|
36
|
-
diagnostic: () => {},
|
|
37
|
-
critical: (code: unknown, message: string) =>
|
|
38
|
-
criticals.push({ code, message }),
|
|
39
|
-
hasCriticalErrors: () => criticals.length > 0,
|
|
40
|
-
} as unknown as InspectorLogger
|
|
41
|
-
return { logger, criticals }
|
|
42
|
-
}
|
|
43
|
-
|
|
44
|
-
describe('resolveWorkflowReferences', () => {
|
|
45
|
-
test('returns null when no workflows property exists', () => {
|
|
46
|
-
const obj = getObjectLiteral(createSourceFile('const x = { name: "a" }'))
|
|
47
|
-
const { logger } = createLogger()
|
|
48
|
-
assert.strictEqual(
|
|
49
|
-
resolveWorkflowReferences(obj, {} as any, 'a', logger),
|
|
50
|
-
null
|
|
51
|
-
)
|
|
52
|
-
})
|
|
53
|
-
|
|
54
|
-
test('returns null for an empty workflows array', () => {
|
|
55
|
-
const obj = getObjectLiteral(
|
|
56
|
-
createSourceFile('const x = { workflows: [] }')
|
|
57
|
-
)
|
|
58
|
-
const { logger } = createLogger()
|
|
59
|
-
assert.strictEqual(
|
|
60
|
-
resolveWorkflowReferences(obj, {} as any, 'a', logger),
|
|
61
|
-
null
|
|
62
|
-
)
|
|
63
|
-
})
|
|
64
|
-
|
|
65
|
-
test('resolves ref() and workflow() string-literal references', () => {
|
|
66
|
-
const obj = getObjectLiteral(
|
|
67
|
-
createSourceFile(
|
|
68
|
-
`const x = { workflows: [ref('buildReport'), workflow('country_capitals')] }`
|
|
69
|
-
)
|
|
70
|
-
)
|
|
71
|
-
const { logger, criticals } = createLogger()
|
|
72
|
-
const result = resolveWorkflowReferences(obj, {} as any, 'planner', logger)
|
|
73
|
-
assert.deepStrictEqual(result, ['buildReport', 'country_capitals'])
|
|
74
|
-
assert.strictEqual(criticals.length, 0)
|
|
75
|
-
})
|
|
76
|
-
|
|
77
|
-
test('flags a raw string literal as a critical error', () => {
|
|
78
|
-
const obj = getObjectLiteral(
|
|
79
|
-
createSourceFile(`const x = { workflows: ['buildReport'] }`)
|
|
80
|
-
)
|
|
81
|
-
const { logger, criticals } = createLogger()
|
|
82
|
-
const result = resolveWorkflowReferences(obj, {} as any, 'planner', logger)
|
|
83
|
-
assert.strictEqual(result, null)
|
|
84
|
-
assert.strictEqual(criticals.length, 1)
|
|
85
|
-
assert.match(criticals[0].message, /string literal/)
|
|
86
|
-
})
|
|
87
|
-
})
|