@company-semantics/contracts 0.31.0 → 0.32.0
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/package.json +1 -1
- package/src/execution/index.ts +5 -5
- package/src/execution/registry.ts +2 -2
- package/src/execution/summary.ts +2 -2
- package/src/execution/timeline-ui.ts +1 -1
- package/src/execution/types.ts +1 -1
- package/src/guards/config.ts +1 -1
- package/src/guards/index.ts +4 -4
- package/src/identity/display-name.ts +1 -1
- package/src/identity/index.ts +2 -2
- package/src/index.ts +14 -12
- package/src/message-parts/builder.ts +1 -1
- package/src/message-parts/execution.ts +1 -1
- package/src/message-parts/index.ts +11 -9
- package/src/message-parts/preview.ts +22 -0
- package/src/message-parts/types.ts +3 -3
- package/src/message-parts/wire.ts +5 -5
- package/src/system/capabilities.ts +1 -1
- package/src/system/diagram.ts +1 -1
- package/src/system/index.ts +2 -2
- package/src/tsconfig.json +2 -2
package/package.json
CHANGED
package/src/execution/index.ts
CHANGED
|
@@ -11,7 +11,7 @@
|
|
|
11
11
|
// Kind Types
|
|
12
12
|
// =============================================================================
|
|
13
13
|
|
|
14
|
-
export type { ExecutionKind } from './kinds
|
|
14
|
+
export type { ExecutionKind } from './kinds'
|
|
15
15
|
|
|
16
16
|
// =============================================================================
|
|
17
17
|
// Definition Types
|
|
@@ -22,7 +22,7 @@ export type {
|
|
|
22
22
|
IconName,
|
|
23
23
|
ExecutionDomain,
|
|
24
24
|
ExecutionKindDefinition,
|
|
25
|
-
} from './types
|
|
25
|
+
} from './types'
|
|
26
26
|
|
|
27
27
|
// =============================================================================
|
|
28
28
|
// Registry
|
|
@@ -32,7 +32,7 @@ export {
|
|
|
32
32
|
EXECUTION_KINDS,
|
|
33
33
|
getExecutionKindDefinition,
|
|
34
34
|
isValidExecutionKind,
|
|
35
|
-
} from './registry
|
|
35
|
+
} from './registry'
|
|
36
36
|
|
|
37
37
|
// =============================================================================
|
|
38
38
|
// Projection Contracts
|
|
@@ -44,11 +44,11 @@ export type {
|
|
|
44
44
|
ExecutionInitiator,
|
|
45
45
|
ExecutionStatus,
|
|
46
46
|
ExecutionSummary,
|
|
47
|
-
} from './summary
|
|
47
|
+
} from './summary'
|
|
48
48
|
|
|
49
49
|
// TimelineUIEvent (user-facing projection)
|
|
50
50
|
export type {
|
|
51
51
|
TimelineStatus,
|
|
52
52
|
TimelineIcon,
|
|
53
53
|
TimelineUIEvent,
|
|
54
|
-
} from './timeline-ui
|
|
54
|
+
} from './timeline-ui'
|
|
@@ -12,8 +12,8 @@
|
|
|
12
12
|
* @see ADR-CONT-029 for design rationale
|
|
13
13
|
*/
|
|
14
14
|
|
|
15
|
-
import type { ExecutionKind } from './kinds
|
|
16
|
-
import type { ExecutionKindDefinition } from './types
|
|
15
|
+
import type { ExecutionKind } from './kinds'
|
|
16
|
+
import type { ExecutionKindDefinition } from './types'
|
|
17
17
|
|
|
18
18
|
// =============================================================================
|
|
19
19
|
// Registry
|
package/src/execution/summary.ts
CHANGED
|
@@ -13,8 +13,8 @@
|
|
|
13
13
|
* @see ADR-CONT-029 for design rationale
|
|
14
14
|
*/
|
|
15
15
|
|
|
16
|
-
import type { ExecutionKind } from './kinds
|
|
17
|
-
import type { ISO8601Timestamp } from './types
|
|
16
|
+
import type { ExecutionKind } from './kinds'
|
|
17
|
+
import type { ISO8601Timestamp } from './types'
|
|
18
18
|
|
|
19
19
|
// =============================================================================
|
|
20
20
|
// Execution Target
|
|
@@ -13,7 +13,7 @@
|
|
|
13
13
|
* @see ADR-CONT-029 for design rationale
|
|
14
14
|
*/
|
|
15
15
|
|
|
16
|
-
import type { ISO8601Timestamp } from './types
|
|
16
|
+
import type { ISO8601Timestamp } from './types'
|
|
17
17
|
|
|
18
18
|
// =============================================================================
|
|
19
19
|
// Timeline Status
|
package/src/execution/types.ts
CHANGED
package/src/guards/config.ts
CHANGED
|
@@ -8,7 +8,7 @@
|
|
|
8
8
|
* Each repo provides its own config values; shared guards consume them.
|
|
9
9
|
*/
|
|
10
10
|
|
|
11
|
-
import type { CheckResult, Soc2ControlArea } from './types
|
|
11
|
+
import type { CheckResult, Soc2ControlArea } from './types';
|
|
12
12
|
|
|
13
13
|
// =============================================================================
|
|
14
14
|
// Size Limits
|
package/src/guards/index.ts
CHANGED
|
@@ -23,7 +23,7 @@ export type {
|
|
|
23
23
|
Soc2ControlStatus,
|
|
24
24
|
Soc2ControlResult,
|
|
25
25
|
Soc2ComplianceOutput,
|
|
26
|
-
} from './types
|
|
26
|
+
} from './types';
|
|
27
27
|
|
|
28
28
|
// Constants (these are type-level, not runtime)
|
|
29
29
|
export {
|
|
@@ -34,7 +34,7 @@ export {
|
|
|
34
34
|
REQUIRED_SOC2_CONTROLS,
|
|
35
35
|
BLOCKING_SOC2_CONTROLS,
|
|
36
36
|
SOC2_SCHEMA_VERSION,
|
|
37
|
-
} from './types
|
|
37
|
+
} from './types';
|
|
38
38
|
|
|
39
39
|
// Config types
|
|
40
40
|
export type {
|
|
@@ -63,11 +63,11 @@ export type {
|
|
|
63
63
|
AlertsConfigGuardConfig,
|
|
64
64
|
BackupConfigGuardConfig,
|
|
65
65
|
Soc2Baselines,
|
|
66
|
-
} from './config
|
|
66
|
+
} from './config';
|
|
67
67
|
|
|
68
68
|
// Config constants (type-level defaults)
|
|
69
69
|
export {
|
|
70
70
|
DEFAULT_SKIP_DIRECTORIES,
|
|
71
71
|
DEFAULT_DOMAIN_SECTIONS,
|
|
72
72
|
DEFAULT_INFRA_SECTIONS,
|
|
73
|
-
} from './config
|
|
73
|
+
} from './config';
|
|
@@ -7,7 +7,7 @@
|
|
|
7
7
|
* @see DECISIONS.md ADR-2026-01-020 for design rationale
|
|
8
8
|
*/
|
|
9
9
|
|
|
10
|
-
import type { UserIdentity } from './types
|
|
10
|
+
import type { UserIdentity } from './types';
|
|
11
11
|
|
|
12
12
|
// =============================================================================
|
|
13
13
|
// Full Name Derivation
|
package/src/identity/index.ts
CHANGED
|
@@ -6,7 +6,7 @@
|
|
|
6
6
|
*/
|
|
7
7
|
|
|
8
8
|
// Types
|
|
9
|
-
export type { ISODateString, UserIdentity } from './types
|
|
9
|
+
export type { ISODateString, UserIdentity } from './types';
|
|
10
10
|
|
|
11
11
|
// Functions
|
|
12
|
-
export { deriveFullName, resolveDisplayName } from './display-name
|
|
12
|
+
export { deriveFullName, resolveDisplayName } from './display-name';
|
package/src/index.ts
CHANGED
|
@@ -47,7 +47,7 @@ export type {
|
|
|
47
47
|
RepoCapability,
|
|
48
48
|
CapabilityManifest,
|
|
49
49
|
AggregatedCapabilities,
|
|
50
|
-
} from './system/index
|
|
50
|
+
} from './system/index'
|
|
51
51
|
|
|
52
52
|
// Guard types (CI guard vocabulary)
|
|
53
53
|
// @see schemas/guard-result.schema.json for JSON Schema
|
|
@@ -84,7 +84,7 @@ export type {
|
|
|
84
84
|
AlertsConfigGuardConfig,
|
|
85
85
|
BackupConfigGuardConfig,
|
|
86
86
|
Soc2Baselines,
|
|
87
|
-
} from './guards/index
|
|
87
|
+
} from './guards/index'
|
|
88
88
|
|
|
89
89
|
export {
|
|
90
90
|
GUARD_SCHEMA_VERSION,
|
|
@@ -97,17 +97,17 @@ export {
|
|
|
97
97
|
REQUIRED_SOC2_CONTROLS,
|
|
98
98
|
BLOCKING_SOC2_CONTROLS,
|
|
99
99
|
SOC2_SCHEMA_VERSION,
|
|
100
|
-
} from './guards/index
|
|
100
|
+
} from './guards/index'
|
|
101
101
|
|
|
102
102
|
// Compatibility manifest (CI guard vocabulary)
|
|
103
103
|
// @see ADR-2025-12-011 for design rationale
|
|
104
|
-
export { COMPATIBILITY } from './compatibility
|
|
105
|
-
export type { Compatibility, Deprecation } from './compatibility
|
|
104
|
+
export { COMPATIBILITY } from './compatibility'
|
|
105
|
+
export type { Compatibility, Deprecation } from './compatibility'
|
|
106
106
|
|
|
107
107
|
// User identity types and functions
|
|
108
108
|
// @see ADR-2026-01-020 for design rationale
|
|
109
|
-
export type { ISODateString, UserIdentity } from './identity/index
|
|
110
|
-
export { deriveFullName, resolveDisplayName } from './identity/index
|
|
109
|
+
export type { ISODateString, UserIdentity } from './identity/index'
|
|
110
|
+
export { deriveFullName, resolveDisplayName } from './identity/index'
|
|
111
111
|
|
|
112
112
|
// MCP tool discovery types
|
|
113
113
|
// @see company-semantics-backend/src/interfaces/mcp/ for implementation
|
|
@@ -119,7 +119,7 @@ export type {
|
|
|
119
119
|
ToolDiscoveryResponse,
|
|
120
120
|
ToolListMessagePart,
|
|
121
121
|
ToolListDataPart,
|
|
122
|
-
} from './mcp/index
|
|
122
|
+
} from './mcp/index'
|
|
123
123
|
|
|
124
124
|
// Message part types and builder functions
|
|
125
125
|
// @see ADR-2026-01-022 for design rationale
|
|
@@ -138,6 +138,8 @@ export type {
|
|
|
138
138
|
AddPartResult,
|
|
139
139
|
// Preview types (Phase 3)
|
|
140
140
|
PreviewArtifactKind,
|
|
141
|
+
IntegrationProvider,
|
|
142
|
+
IntegrationArtifactContent,
|
|
141
143
|
PreviewArtifact,
|
|
142
144
|
PreviewData,
|
|
143
145
|
PreviewPart,
|
|
@@ -168,7 +170,7 @@ export type {
|
|
|
168
170
|
MessageStartDataPart,
|
|
169
171
|
MessageDeltaDataPart,
|
|
170
172
|
MessageCompleteDataPart,
|
|
171
|
-
} from './message-parts/index
|
|
173
|
+
} from './message-parts/index'
|
|
172
174
|
|
|
173
175
|
export {
|
|
174
176
|
isTextPart,
|
|
@@ -180,7 +182,7 @@ export {
|
|
|
180
182
|
buildParts,
|
|
181
183
|
getDroppedCount,
|
|
182
184
|
WireSurfaceBuilder,
|
|
183
|
-
} from './message-parts/index
|
|
185
|
+
} from './message-parts/index'
|
|
184
186
|
|
|
185
187
|
// Execution kind types and registry
|
|
186
188
|
// @see ADR-CONT-029 for design rationale
|
|
@@ -198,10 +200,10 @@ export type {
|
|
|
198
200
|
TimelineStatus,
|
|
199
201
|
TimelineIcon,
|
|
200
202
|
TimelineUIEvent,
|
|
201
|
-
} from './execution/index
|
|
203
|
+
} from './execution/index'
|
|
202
204
|
|
|
203
205
|
export {
|
|
204
206
|
EXECUTION_KINDS,
|
|
205
207
|
getExecutionKindDefinition,
|
|
206
208
|
isValidExecutionKind,
|
|
207
|
-
} from './execution/index
|
|
209
|
+
} from './execution/index'
|
|
@@ -18,7 +18,7 @@
|
|
|
18
18
|
* @see DECISIONS.md ADR-2026-01-022 for design rationale
|
|
19
19
|
*/
|
|
20
20
|
|
|
21
|
-
import type { AssistantMessagePart, TextPart, SurfacePart } from './types
|
|
21
|
+
import type { AssistantMessagePart, TextPart, SurfacePart } from './types'
|
|
22
22
|
|
|
23
23
|
// =============================================================================
|
|
24
24
|
// Builder State
|
|
@@ -16,16 +16,18 @@ export type {
|
|
|
16
16
|
TablePart,
|
|
17
17
|
SurfacePart,
|
|
18
18
|
AssistantMessagePart,
|
|
19
|
-
} from './types
|
|
19
|
+
} from './types'
|
|
20
20
|
|
|
21
21
|
// Preview types
|
|
22
22
|
export type {
|
|
23
23
|
PreviewArtifactKind,
|
|
24
|
+
IntegrationProvider,
|
|
25
|
+
IntegrationArtifactContent,
|
|
24
26
|
PreviewArtifact,
|
|
25
27
|
PreviewData,
|
|
26
28
|
PreviewPart,
|
|
27
29
|
PreviewDataPart,
|
|
28
|
-
} from './preview
|
|
30
|
+
} from './preview'
|
|
29
31
|
|
|
30
32
|
// Confirmation types
|
|
31
33
|
export type {
|
|
@@ -37,7 +39,7 @@ export type {
|
|
|
37
39
|
ConfirmationResponseData,
|
|
38
40
|
ConfirmationResponsePart,
|
|
39
41
|
ConfirmationResponseDataPart,
|
|
40
|
-
} from './confirmation
|
|
42
|
+
} from './confirmation'
|
|
41
43
|
|
|
42
44
|
// Execution result types
|
|
43
45
|
export type {
|
|
@@ -45,7 +47,7 @@ export type {
|
|
|
45
47
|
ExecutionResultData,
|
|
46
48
|
ExecutionResultPart,
|
|
47
49
|
ExecutionResultDataPart,
|
|
48
|
-
} from './execution
|
|
50
|
+
} from './execution'
|
|
49
51
|
|
|
50
52
|
// Lifecycle types (Phase 1 streaming)
|
|
51
53
|
export type {
|
|
@@ -60,13 +62,13 @@ export type {
|
|
|
60
62
|
MessageStartDataPart,
|
|
61
63
|
MessageDeltaDataPart,
|
|
62
64
|
MessageCompleteDataPart,
|
|
63
|
-
} from './lifecycle
|
|
65
|
+
} from './lifecycle'
|
|
64
66
|
|
|
65
67
|
// Type guards
|
|
66
|
-
export { isTextPart, isSurfacePart } from './types
|
|
68
|
+
export { isTextPart, isSurfacePart } from './types'
|
|
67
69
|
|
|
68
70
|
// Builder functions
|
|
69
|
-
export type { PartBuilderState, AddPartResult } from './builder
|
|
71
|
+
export type { PartBuilderState, AddPartResult } from './builder'
|
|
70
72
|
export {
|
|
71
73
|
createPartBuilder,
|
|
72
74
|
addText,
|
|
@@ -74,7 +76,7 @@ export {
|
|
|
74
76
|
addPart,
|
|
75
77
|
buildParts,
|
|
76
78
|
getDroppedCount,
|
|
77
|
-
} from './builder
|
|
79
|
+
} from './builder'
|
|
78
80
|
|
|
79
81
|
// Wire format builder
|
|
80
|
-
export { WireSurfaceBuilder } from './wire
|
|
82
|
+
export { WireSurfaceBuilder } from './wire'
|
|
@@ -28,6 +28,28 @@ export type PreviewArtifactKind =
|
|
|
28
28
|
| 'notification' // Notification to user/team
|
|
29
29
|
| 'task' // Task creation
|
|
30
30
|
| 'calendar' // Calendar event
|
|
31
|
+
| 'integration' // Integration connect/disconnect action
|
|
32
|
+
|
|
33
|
+
/**
|
|
34
|
+
* Integration provider types.
|
|
35
|
+
*/
|
|
36
|
+
export type IntegrationProvider = 'slack' | 'google' | 'zoom'
|
|
37
|
+
|
|
38
|
+
/**
|
|
39
|
+
* Content structure for integration artifacts.
|
|
40
|
+
*
|
|
41
|
+
* Used when kind='integration' to define the action payload.
|
|
42
|
+
*/
|
|
43
|
+
export interface IntegrationArtifactContent {
|
|
44
|
+
/** The integration action to perform */
|
|
45
|
+
action: 'connect' | 'disconnect'
|
|
46
|
+
/** Target provider */
|
|
47
|
+
provider: IntegrationProvider
|
|
48
|
+
/** Connection ID for disconnect (required for disconnect) */
|
|
49
|
+
connectionId?: string
|
|
50
|
+
/** Workspace ID for multi-workspace providers */
|
|
51
|
+
workspaceId?: string
|
|
52
|
+
}
|
|
31
53
|
|
|
32
54
|
/**
|
|
33
55
|
* A single artifact within a preview.
|
|
@@ -13,9 +13,9 @@
|
|
|
13
13
|
* @see DECISIONS.md ADR-2026-01-022 for design rationale
|
|
14
14
|
*/
|
|
15
15
|
|
|
16
|
-
import type { ToolListMessagePart } from '../mcp/index
|
|
17
|
-
import type { PreviewPart } from './preview
|
|
18
|
-
import type { ConfirmationPart, ConfirmationResponsePart } from './confirmation
|
|
16
|
+
import type { ToolListMessagePart } from '../mcp/index'
|
|
17
|
+
import type { PreviewPart } from './preview'
|
|
18
|
+
import type { ConfirmationPart, ConfirmationResponsePart } from './confirmation'
|
|
19
19
|
|
|
20
20
|
// =============================================================================
|
|
21
21
|
// Narrative Parts (Streamable)
|
|
@@ -10,19 +10,19 @@
|
|
|
10
10
|
* @see DECISIONS.md ADR-2026-01-022 for design rationale
|
|
11
11
|
*/
|
|
12
12
|
|
|
13
|
-
import type { MCPToolDescriptor, ToolListDataPart } from '../mcp/index
|
|
14
|
-
import type { PreviewDataPart, PreviewData } from './preview
|
|
13
|
+
import type { MCPToolDescriptor, ToolListDataPart } from '../mcp/index'
|
|
14
|
+
import type { PreviewDataPart, PreviewData } from './preview'
|
|
15
15
|
import type {
|
|
16
16
|
ConfirmationData,
|
|
17
17
|
ConfirmationDataPart,
|
|
18
18
|
ConfirmationResponseData,
|
|
19
19
|
ConfirmationResponseDataPart,
|
|
20
|
-
} from './confirmation
|
|
21
|
-
import type { ExecutionResultData, ExecutionResultDataPart } from './execution
|
|
20
|
+
} from './confirmation'
|
|
21
|
+
import type { ExecutionResultData, ExecutionResultDataPart } from './execution'
|
|
22
22
|
import type {
|
|
23
23
|
MessageStartDataPart,
|
|
24
24
|
MessageCompleteDataPart,
|
|
25
|
-
} from './lifecycle
|
|
25
|
+
} from './lifecycle'
|
|
26
26
|
|
|
27
27
|
/**
|
|
28
28
|
* Factory for creating wire-format surface parts.
|
|
@@ -15,7 +15,7 @@
|
|
|
15
15
|
* @see ADR-CONTRACTS-NNN in DECISIONS.md
|
|
16
16
|
*/
|
|
17
17
|
|
|
18
|
-
import type { DiagramNode, FlowStage } from './index
|
|
18
|
+
import type { DiagramNode, FlowStage } from './index'
|
|
19
19
|
|
|
20
20
|
// =============================================================================
|
|
21
21
|
// Types
|
package/src/system/diagram.ts
CHANGED
package/src/system/index.ts
CHANGED
|
@@ -79,7 +79,7 @@ export type {
|
|
|
79
79
|
DiagramEdge,
|
|
80
80
|
DiagramSpec,
|
|
81
81
|
DiagramSnapshot,
|
|
82
|
-
} from './diagram
|
|
82
|
+
} from './diagram'
|
|
83
83
|
|
|
84
84
|
// Repository capability types
|
|
85
85
|
export type {
|
|
@@ -88,4 +88,4 @@ export type {
|
|
|
88
88
|
RepoCapability,
|
|
89
89
|
CapabilityManifest,
|
|
90
90
|
AggregatedCapabilities,
|
|
91
|
-
} from './capabilities
|
|
91
|
+
} from './capabilities'
|